Setting up TYPO3 with DDEV ¶

Setting up the prerequisites ¶

You will need to install docker and other System requirements .

Then install DDEV as described in the Installation instructions.

Clone TYPO3 ¶

Create a clone of the TYPO3 git repository as described in git clone .

mkdir t3master
cd t3master
git clone git://git.typo3.org/Packages/TYPO3.CMS.git .
composer install
cd Build
yarn install
yarn build
cd ..

Configure DDEV ¶

ddev config

Now edit the configuration file .ddev/config.yaml and make sure you change the PHP version to the required version (in TYPO3 9 master this is PHP 7.2).

php_version: "7.2"

Start DDEV ¶

ddev start

Check for database credentials ¶

Let DDEV dump information:

ddev describe

You will need username, password, Database name, host and port of the MySQL credentials to setup your TYPO3 installation, e.g.

MySQL Credentials
-----------------
Username:            db
Password:            db
Database name:       db
Host:                db
Port:                3306

FIRST_INSTALL ¶

Now, create a file FIRST_INSTALL :

touch FIRST_INSTALL

Setup your TYPO3 installation ¶

Now load the URL as shown by ddev start in your browser with the path /typo3 appended to it. Typically this will be http://t3master.ddev.local/typo3 .

You will now be guided through the basic installation steps by TYPO3.

If you use the HTTPS url you may get a “Privacy error” or something similar from your browser. You will need to get your browser to ignore this warning (e.g. Advanced:Proceed to t3master.ddev.local (unsafe) , depends on browser).

The warning is due to the fact that self-signed certificates are being used.

If you are getting a trustedHostsPattern error on initial access, try accessing the HTTP domain first.

Additional setup ¶

Be sure to add the .ddev directory to your local gitignore (e.g. .git/info/exclude ).

Shutdown DDEV ¶

When you are done you can do:

ddev stop

or:

ddev remove

ddev remove does not remove the database. For a list of commands see:

ddev help

Failed to start <projectname>: db service health check timed out

ddev remove --remove-data

ddev start

Resources ¶

Remember, you can use the Slack channels to ask for help! Follow the general convention for the channels: not too chatty, get straight to the point and ask, be nice. Register for the TYPO3 slack workspace if you have not done so already.