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.