Install TYPO3 via Composer

The recommended way of installing TYPO3 is via Composer, as described on this page. If you do not want to use Composer, follow the package installation guide.

You have more ways to install TYPO3 via composer:

  • Install regular via loading the needed packages. Use Composer helper to generate the composer command.
  • Install the cms-base-distribution package. This is helpful when you are use ddev, because it configures your database and mailserver for Mailhog.

To create a new TYPO3 project using the TYPO3 Base Distribution:

# Download the Base Distribution, the latest "sprint" release (10)
composer create-project typo3/cms-base-distribution YourNewProjectFolder

To create a new TYPO3 project using the TYPO3 Base Distribution in a ddev environment:

# create and change directory
mkdir my-typo3-site
cd my-typo3-site
# set project type and docroot
ddev config --project-type=typo3 --docroot=public --create-docroot
ddev start
# Download the Base Distribution, the latest "LTS" release (10)
ddev composer create "typo3/cms-base-distribution:^10" --prefer-dist
# create FIRST_INSTALL file in the folder public/
ddev exec touch public/FIRST_INSTALL
# start project
ddev launch


For Windows users: To install TYPO3 via the composer command, it should be started as admin or explicitly given the right to create symlinks (use for example a powershell or git bash started with admin rights).

After composer create project ... executed, you should have the following folder structure:

├── .gitignore
├── composer.json
├── composer.lock
├── public
├── var
└── vendor

Point the document root of your web server to the public folder.

Tutorial from the official TYPO3 YouTube channel

Next Steps

Continue with The Admin Tool.