Welcome to our comprehensive guide on Installing TYPO3 with DDEV—a step-by-step journey into setting up the TYPO3 development environment. In this tutorial, we will walk you through the process of harnessing the power of DDEV, Docker, and Composer to create a local development environment for TYPO3. Whether you're an experienced developer or just beginning your TYPO3 journey, this guide will provide you with the tools and knowledge to have your TYPO3 development workflow. Let's get on with Installing TYPO3 with DDEV!
Before we begin, make sure you have the following prerequisites installed on your local setup:
- Get the Docker Installed
- Get the DDEV Installed
Note: DDEV and Docker must be installed before proceeding with TYPO3 installation. If you encounter any issues while installing DDEV, you can seek support on the DDEV Discord server.
- Open your terminal or command prompt.
- Create a new directory where you want to install TYPO3.
mkdir t3example cd t3example
Now, let's create a new DDEV project for TYPO3
When prompted, provide the following information:
ddev config --php-version 8.1 # Give the following answers when prompted: Project name (t3example): Docroot Location (current directory): public Create docroot at /home/myuser/projects/t3/t3example/public? [Y/n] (yes): Y Project Type [php, typo3, ...] (php): typo3
Alternatively, you can supply all the required parameters in a single command:
ddev config --project-type=typo3 --docroot=public --create-docroot --php-version 8.1
Project Type: It is essential to set this value as "typo3."
Docroot: This directory contains all the files accessible through a web browser. Typically, it's referred to as the "public" folder.
Create-Docroot: By enabling this option, DDEV will create the directory if it doesn't already exist, ensuring a smooth setup process.
Once the project is configured, start it by running:
Note: TYPO3 is not installed yet.
To install TYPO3, use Composer by running the following command within your project directory:
ddev composer create "typo3/cms-base-distribution:^12"
When prompted, confirm that it's okay to overwrite files in this directory by typing "yes."
Congratulations! You now have a Composer-based TYPO3 installation.
With TYPO3 installed, you can set it up using either the command line or the web-based installer.
Command Line Setup (TYPO3 12.1 and newer):
Starting with TYPO3 12.1, you can use a CLI command to set up TYPO3:
ddev exec ./vendor/bin/typo3 setup
Web-Based Setup (1,2,3 Install Tool):
1. Create a file named `FIRST_INSTALL` in your webroot:
Generate a file named 'FIRST_INSTALL' within your webroot using the following command.
ddev exec touch public/FIRST_INSTALL
2.Now, open the installer in your browser:
Launch the TYPO3 installer by running:
ddev launch typo3/install.php
3.Access the TYPO3 Backend:
After completing the installation, navigate to the TYPO3 backend by entering:
ddev launch typo3
You can now log in using the credentials you provided during the installation process.
DDEV automatically created a database for your TYPO3 project during configuration. Database credentials are stored in the `config/system/additional.php` file.
To interact with the database, you can use the following command:
ddev launch -p
DDEV sets up a configuration for fake email sending in `config/system/additional.php`. You can check what emails have been sent using the following command:
ddev launch -m
To stop all running DDEV projects, use the following command:
If you need to delete a specific project, navigate to the project's root folder and use the following command:
ddev delete --omit-snapshot
This will remove all containers related to the project and delete the associated database.
You've successfully installed TYPO3 on your local machine using DDEV, Docker, and Composer. This development environment allows you to build and test TYPO3 websites and applications with ease. Happy TYPO3 development!
You might find similar topics of interest on this blog here: