Welcome to the TYPO3 installation guide. This guide covers each of the steps required to install TYPO3 using Composer.
For more information on how to deploy TYPO3 to a live environment, visit the deploying TYPO3 chapter.
Command line (CLI) access with the ability to create directories and symbolic links.
Access to Composer via the CLI (for local development)
Access to the web server's root directory
Database with appropriate credentials
Execute Composer Create-Project¶
The following script will install TYPO3 v12 which is the latest release of the CMS. If you wish to install the long term support (LTS) release of TYPO3, visit the TYPO3 v11 Installation guide.
At the root level of your web server, execute the following command:
composer create-project typo3/cms-base-distribution:^12 example-project-directory # Use console command to run the install process # or use the Install Tool GUI (See below) ./vendor/bin/typo3 setup
composer create-project "typo3/cms-base-distribution:^12" example-project-directory # Use console command to run the install process # or use the Install Tool GUI (See below) ./vendor/bin/typo3 setup
# Create a directory for your project mkdir example-project-directory # Go into that directory cd example-project-directory # Tell DDEV to create a new project of type "typo3" # 'docroot' MUST be 'public' PHP 8.1 is required by TYPO3 v12 ddev config --project-type=typo3 --docroot=public --create-docroot --php-version 8.1 # Fetch a basic TYPO3 installation and its' dependencies ddev composer create "typo3/cms-base-distribution:^12" # Depending on your DDEV version the configuration file may have been # created in an outdated location, you can move it with mkdir -p config/system/ && mv public/typo3conf/AdditionalConfiguration.php $_/additional.php # Use console command to run the install process # or use the Install Tool GUI (See below) ddev exec ./vendor/bin/typo3 setup
This command pulls down the latest release of TYPO3 and places it in the
After this command has finished running,
will contain the following structure:
. ├── .gitignore ├── composer.json ├── composer.lock ├── LICENSE ├── public ├── README.md ├── var └── vendor
Run the setup process¶
Setup TYPO3 in the console¶
New in version 12.1: Starting with TYPO3 v12.1 a new CLI command
setup is introduced as
an alternative to the existing GUI-based web installer.
Interactive / guided setup (questions/answers):
ddev exec ./vendor/bin/typo3 setup
Or use the GUI installer in the browser¶
Create an empty file called
FIRST_INSTALL in the
echo $null >> public/FIRST_INSTALL
ddev exec touch public/FIRST_INSTALL
Access TYPO3 via a web browser¶
After you have configured your web server to point at the
public directory of your project,
TYPO3 can be accessed via a web browser. When accessing a new site for the first time, TYPO3 automatically
redirects all requests to
/typo3/install.php to complete the installation process.
When accessing the page via HTTPS, a "Privacy error" or similar warning is likely to occur. In a local environment it is safe to ignore this warning by forcing the browser to ignore similar exceptions for this domain.
The warning is due to the fact that self-signed certificates are being used.
If there is a
trustedHostsPattern error on initial access, accessing TYPO3 without HTTPS (
http://) is also an option.
TYPO3 will now scan the host environment. During the scan TYPO3 will check the host system for the following:
Minimum required version of PHP is installed.
Required PHP extensions are loaded.
php.ini is configured.
TYPO3 is able to create and delete files and directories within the installation's root directory.
If no issues are detected, the installation process can continue.
In the event that certain criteria are not met, TYPO3 will display a list of issues it has detected accompanied by a resolution for each issue.
Once changes have been made, TYPO3 can re-scan the host environment by reloading the page
Select a Database¶
Select a database connection driver and enter the credentials for the database.
TYPO3 can either connect to an existing empty database or create a new one.
The list of databases available is dependent on which database drivers are installed on the host.
For example, if an instance of TYPO3 is intended to be used with a MySQL database then the PHP extension 'pdo_mysql' is required. Once it's installed, MySQL Database will be available as an option.
Create Administrative User & Set Site Name¶
An administrator account needs to be created to gain access to TYPO3's backend.
An email address for this user can also be specified and a name can be given.
The password must comply with the configured password policy.
TYPO3 offers two options for initialisation: creating an empty starting page or it can go directly to the backend administrative interface. Beginners should select the first option and allow TYPO3 to create an empty starting page. This will also generate a site configuration file.
Now that installation is complete, TYPO3 can be configured.
We also provide a step-by-step tutorial on how to Install TYPO3 using DDEV. The tutorial also includes a video.