This guide explains how to install TYPO3 using Composer or the classic method, prepare your environment, configure the database, and access the backend for the first time. Follow the steps carefully to deploy a stable, production-ready TYPO3 instance from day one.
Choose the Right TYPO3 Version Before You Install
Your PHP compatibility and security support and upgrade strategy will depend on your TYPO3 version.
LTS (Long-Term Support)
- The system provides security maintenance support for multiple years.
- The system provides security maintenance support for all new production projects.
- The system maintains stable performance which enables safe system upgrades.
ELTS (Extended Long-Term Support)
- The system offers paid security support for all previous LTS releases.
- The system works best with existing enterprise systems that require long-term support.
- The system works best with existing systems which need no updates.
Sprint Releases
- The system provides a brief time frame for support.
- The system focuses on developing new features.
- The system only functions as a testing tool and early adopter platform.
PHP Compatibility
The system supports specific PHP versions which are associated with each TYPO3 release. Users must check official system requirements to verify system compatibility before starting installation. Using PHP versions which the system does not support will cause the main system and its extensions to stop working.
Recommendation:
The organization should use the latest LTS version for all upcoming projects. The organization should use ELTS when they face limitations which prevent them from performing upgrades. Organizations should not use sprint releases for their production environment.
If you are currently running an older TYPO3 version, review the upgrade implications before installing or migrating. Our guide, Top Reasons to Upgrade from TYPO3 v12 to v13, explains the benefits, risks, and preparation steps in detail.
TYPO3 Installation Methods Explained
The installation of TYPO3 requires different methods which depend on your existing infrastructure and planned maintenance procedures.
The installation method affects all aspects of system operation including upgrade management and security protection and system capacity to grow over time.
Composer Installation (Recommended)
The official installation method provides modern installation capabilities
- TYPO3 operates as a dependency which Composer installation method manages
- The system enables users to update core components and extension files with greater efficiency
- The system allows users to control versioning while implementing continuous integration and deployment processes
- The system provides business advantages which make it suitable for enterprise development work.
Classic Source Package
- The user must obtain files through manual download to perform their installation.
- The installation process needs the user to create their FIRST_INSTALL file.
- The system provides functions that work in shared hosting environments.
- The system enables users to execute system upgrades through a less organized procedure.
Local Development (DDEV / XAMPP)
The system prepares software for testing and development work before it goes to production.
DDEV (Recommended)
- The system uses Docker technology which enables it to create production environment simulations.
- The system provides a development environment which enables teams to work together effectively.
XAMPP
- The system creates an uncomplicated local testing environment.
- The system enables users to perform fundamental testing operations.
- The system does not meet the requirements for testing in commercial business settings.
Installation Method Overview
Method | When to Use | Hosting | Maintenance |
Composer | Production and long-term projects | VPS, cloud, dedicated servers | Structured and upgrade-safe |
Source Package | Shared hosting setups | Limited server access | Manual updates |
Local (DDEV/XAMPP) | Development and testing | Local machine | Safe upgrade simulation |
Recommendation: For modern TYPO3 projects, use Composer for production and DDEV for local development.
What You Need Before Installing TYPO3
Before installing TYPO3, confirm your server meets the official system requirements for your selected version.
Server Requirements
PHP
- Use a PHP version supported by your TYPO3 release (verify officially).
- For TYPO3 v13, PHP 8.2+ is required.
- Required extensions typically include:
curl, fileinfo, mbstring, openssl, intl, pdo, json. - Ensure
memory_limitand execution time for production.
Database
- MySQL (8.0+)
- MariaDB (10.4+)
- PostgreSQL (10+)
- SQLite (development only)
- Use
utf8mb4encoding.
Web Server
- Apache, NGINX, IIS, or Caddy
- Document root must point to
/public.
Resources
- Minimum 256MB RAM
- 512MB+ recommended for production
Composer
- Required for modern installations
- Use Composer 2.x
Required Access & Tools
- SSH Access (Recommended) – Required for Composer and CLI operations
- FTP/SFTP – Needed for classic source package installations
- Hosting Control Panel – For database creation and document root configuration
- Web Browser – To access the install tool and backend
Not sure if your infrastructure is suitable? Read our guide on choosing the right TYPO3 hosting for your website to avoid performance and scalability issues.
Install TYPO3 with Composer (Step-by-Step)
Composer is the recommended method for installing TYPO3 in modern production environments. It ensures clean dependency management, easier updates, and long-term maintainability.
Step 1: Create TYPO3 Project via Composer
Connect to your server via SSH and navigate to the directory where you want to create your project.
Run:
composer create-project typo3/cms-base-distribution my-typo3-site
This command:
- Downloads the latest compatible TYPO3 core
- Sets up the standard project structure
- Installs required dependencies
- Creates the
/publicdirectory for web access
After installation, navigate into your project folder:
cd my-typo3-site
Step 2: Configure Document Root (/public)
For security reasons, TYPO3 must run from the /public directory.
Set your web server document root to:
/path-to-your-project/public
- In Apache or NGINX configuration, ensure the root points to this directory.
- Do not point your domain to the project root, only to
/public.
If this is misconfigured, TYPO3 will not load correctly and may expose sensitive files.
Step 3: Database Setup
Create a new database before launching the install tool.
- Create a new database (utf8mb4 recommended)
- Create a dedicated database user
- Assign full privileges to that user
- Note the following:
- Database name
- Username
- Password
- Host (usually
localhost)
You will need these credentials during installation.
Step 5: Start TYPO3 Installation
5.1 Launch the Installer:
- Visit Your Site’s Domain:
Open your web browser and navigate to your domain (e.g., https://yourdomain.com). You should see the TYPO3 installation page. Double-check your file permissions and document root configuration if it doesn't show up. - Create the FIRST_INSTALL File:
To create an empty file called FIRST_INSTALL, follow these steps:- Place the file in the root directory of your TYPO3 installation.
- This file will start the TYPO3 install tool.
- The installation process will then begin.
5.2 System Environment Check:
- TYPO3 Automated Check:
When you launch the installer, TYPO3 will automatically check your server environment to ensure everything is correct. This means checking PHP versions, whether database connections work, the ability to write files, and other system settings. - Resolving Problems, if you happen to have them:
If you happen to have any problems, like missing PHP extensions or low memory, solve them before continuing. The installation tool will tell you how to solve the problem.
Step 2: Upload TYPO3 to Your Web Server
2.1 Extract Files
- Unzip the Downloaded TYPO3 Archive Locally:
Essentially, you can upload the zip straight through an FTP server and unzip it using SSH. then, on your local machine, it will create a folder with the TYPO3 files. - After that, upload the files using FTP:
- You can use an FTP client, like FileZilla, to upload the TYPO3 folder. Choose the directory on your server where you want TYPO3 installed.
- You can upload the files directly to your server's document root or a subfolder. This depends on how you want your website structured.
2.2 Set the Correct Document Root
- Ensure Your Web Root Points to the /public Folder:
- After you have uploaded the TYPO3 files, the web root folder must point to the /public folder inside the TYPO3 package. This is important because TYPO3 must run from this directory for security reasons.
- Adjust the document root in your hosting control panel (like cPanel or Plesk) to this folder, if necessary.
Note: “If you use NGINX or Apache, you might need to change the server settings to use the right document root.”
Step 3: File Permissions and Folder Structure
3.1 Set Write Permissions:
TYPO3 has limited directories that it will need to write into to store its files and any configuration data. Use your FTP client or a terminal. Set file permissions to 664. Set directory permissions to 775 on these directories:
fileadmin/
typo3conf/
var/
3.2 Verify Permissions:
Ensure your web server's username (typically www-data or apache) has write permissions on these folders. If the permissions are incorrect, the installation process will fail, preventing TYPO3 from working correctly.
Step 6: Database Configuration
6.1 Enter Database Credentials:
When you get to the install screen, you will have a place to enter the database information:
- Host - This will usually be localhost, unless you host your database elsewhere.
- Database Name - This will be the database name you created earlier.
- Username - This should be the database username with full permissions.
- Password - This is the password you set for your database user account.
6.2 Database Schema Setup:
TYPO3 will create the database tables, set the schema required for your site, and install everything for you. There is nothing that you need to do manually in this.
Step 7: Create Admin Account
7.1 Admin Username and Password:
Select a secure admin username and password. You will use that account to log into the TYPO3 backend to manage your site.
7.2 Enter Your Email Address:
Enter a valid email address that will get used for your admin account.
7.3 Set Your Site Name:
This is where you will enter your website name for the site. You can change this later in the backend if you want to.
Step 8: Select Installation Type
8.1 Introduction Package:
If you are new to TYPO3 or want to start your project, choose the Introduction Package. It has sample content available. This option installs a demo site with sample content and layouts to help you get familiar with TYPO3.
8.2 Blank Installation:
If you are an advanced user or want a blank site to start, select the Blank Installation. This installation will set up TYPO3 without any content or pre-made layouts. You can then use it for your custom project.
Step 9: Final Steps and Backend Access
9.1 Installation Complete:
After the installation, you will arrive at the core system files that TYPO3 generated to run the CMS.
9.2 Access the Backend:
Now you can work with TYPO3 by navigating to the TYPO3 backend interface at https:// yourdomain.com/typo3. Log in using the administrator credentials created during the setup process.
Post TYPO3 Installation Tips
Once TYPO3 is working, there are a few things to think about. You should secure your site, improve its features, and ensure it stays stable over time.
1. Remove FIRST_INSTALL File
When the installation is done, TYPO3 will leave a file named FIRST_INSTALL in the root directory. This file is the installation tool and will not work for you after installation.
Please remove or rename the FIRST_INSTALL file right away. This will prevent unauthorized access to your setup wizard.
2. Configure Clean URLs
TYPO3 supports clean URLs that are friendly to search engines, but your server must be configured.
- Apache: TYPO3 delivers a default .htaccess file. Please make sure you have mod_rewrite enabled to support .htaccess.
- NGINX: In Nginx, you must define clean URL rules in the conf file.
Once you defined clean URLs, please test your frontend URL. If you see index.php?id=1 in the URL you will need to adjust your rewrite rules.
3. Update and Extend TYPO3
TYPO3 is built to be extended. After logging into the backend, go to the Extension Manager. Here, you can browse and install official or custom extensions. You can also check for core updates to keep everything current.
TYPO3 regularly releases security and maintenance updates. Keeping your system updated is important for better performance and security.
4. Set Up a Backup Strategy
Every Content Management System needs to have backups. You will want to have a backup system in place that backs up both:
- The file system (your TYPO3 files and uploads)
- The database (this is where all your content and config live)
Use your hosting provider's built-in backup tools, or install a TYPO3 extension to automate backups. Regular backups will give you peace of mind.
Conclusion
Installing TYPO3 does not need to be complicated. Using a step-by-step approach is entirely manageable, even if you have not done it before.
You can create a strong and reliable Content Management System. You can do it yourself or work with a TYPO3 Agency. Now you've got everything set up and are ready to go.
Log in to the TYPO3 backend, set up your first pages, and see what TYPO3 can do.
Now you can go and create something awesome, your TYPO3 site is ready!
Contact for Internet agency and TYPO3 projects
Sven Thelemann
Service Partner - Germany

Be the First to Comment