Setup the TYPO3 installation


If you are setting TYPO3 up with DDEV, you can skip this page and jump straight to

git clone

Switch into your empty htdocs directory of choice and clone the TYPO3 CMS core repository:

git clone .

Git GUIs

If you rather like to work with your favorite Git GUI, we compiled a list of the ones used throughout the core team here.

composer install

– required (unless run composer install from container solution, such as DDEV, see composer install)


If you plan to use a Docker based container solution for setting up your TYPO3 installation (for example using DDEV), you can perform the step composer install later and let it run inside your Docker container.

Information about setting up Composer is found in previous chapter.

Composer cannot detect the TYPO3 version of your cloned project because there is none. Before you run composer install you need to export the COMPOSER_ROOT_VERSION environment variable. Here you need to set a full version string matching the TYPO3 version of your clone.


# cd <cloned project>

Run composer install in the same directory you cloned the TYPO3 CMS core repository to. This may take several minutes:

# cd <cloned project>
composer install

yarn install


This step is not necessary to setup a working environment. You may however want to test this step because you might be needing it later if you make changes in the frontend SCSS or TypeScript files in Build/Sources. If not, skip to Setting up a Working TYPO3 Installation.

Go to the Build folder of your TYPO3 install root directory. Install all dependencies with yarn install. Wait for the the end of the install progress. Type yarn build for the build process.

cd Build
yarn install
yarn build
cd ..

yarn tasks

The following is a list of available build targets (see package.json for an up-to-date list). You will only be needing these if you want to do something specific. Usually, it should suffice to use yarn install and yarn build.

  • yarn build - Compile everything.
  • yarn build-css - Compile SCSS to CSS.
  • yarn lint - Test your SCSS and ts files.
  • yarn build-js - Compile JavaScript.
  • yarn format - Resolve Style issues.
  • yarn update - Update dependencies (Use this if you are really sure what you’re doing).

Setting up a Working TYPO3 Installation

You will now need to use your git clone to setup a working installation of TYPO3. There are many different ways how you can do this. We provide a few examples in the Appendix: