TYPO3 setup on first installation

You can set up TYPO3 either via a console command or by using the web-based Install Tool.

Set up TYPO3 using the console

New in version 12.1

Starting with TYPO3 12.1, a new CLI command typo3 setup is available as an alternative to the traditional web-based installer.

To perform an interactive guided setup, run:

# Run TYPO3 CLI setup (database credentials are pre-filled)
ddev typo3 setup --server-type=other --driver=mysqli --host=db --port=3306 --dbname=db --username=db --password=db

When prompted, provide the following answers to match the default DDEV configuration:

Admin username (user will be "system maintainer") ? j.doe
Admin user and installer password ?
Admin user email ? j.doe@example.org
Give your project a name [default: New TYPO3 Project] ? My Project
Create a basic site? Please enter a URL [default: no] https://my-project.ddev.site
✓ Congratulations - TYPO3 Setup is done.

Set up TYPO3 using the web installer (1-2-3 install tool)

Alternatively, you can use the web-based Install Tool to set up TYPO3.

Create a file named FIRST_INSTALL in your webroot:
```
ddev exec touch public/FIRST_INSTALL
```
Copied!
Open the TYPO3 installer in your browser:
```
ddev launch /typo3/install.php
```
Copied!
After completing the setup, access the TYPO3 backend:
```
ddev launch /typo3
```
Copied!

Log in using the credentials you just created during the setup process.

Set the application context for local development

After completing the setup, TYPO3 will run in the "Production" application context by default.

For local development, it is recommended to switch to the "Development/DDEV" context for better error reporting, debugging features, and developer-friendly features.

Edit your .ddev/config.yaml and add:

.ddev/config.yaml

environment:
  - TYPO3_CONTEXT=Development/DDEV

Restart DDEV to apply the changes:

ddev restart