--- title: "Install TYPO3 with DDEV: Docker Based and Composer Ready" url: "https://nitsantech.de/en/blog/installing-typo3-with-ddev" description: "Install TYPO3 with DDEV: Docker-based, configure the project, install TYPO3 via Composer, and complete the setup through CLI/Webinstaller." date: 2024-02-01 modified: 2026-01-29 lastUpdated: 2026-02-25 keywords: - TYPO3 - TYPO3 CMS - TYPO3 Installation - TYPO3 DDev - TYPO3 DDev install - TYPO3 DDev Installation - DDev Installation categories: - TYPO3 CMS --- # Install TYPO3 with DDEV: Docker Based and Composer Ready Installing TYPO3 with DDEV: A Step-by-Step Guide ================================================ 03 Oct 2023 [![](https://nitsantech.de/fileadmin/ns_theme_nitsan/Team_Slider/Sven_Thelemann.png)](https://nitsantech.de/en/blog/author/sven-thelemann) [Sven Thelemann](https://nitsantech.de/en/blog/author/sven-thelemann) [ TYPO3 CMS ](https://nitsantech.de/en/categories/typo3-cms) ![Installing TYPO3 with DDEV: A Step-by-Step Guide](https://nitsantech.de/fileadmin/ns_theme_ns2019/blog/_live/Installing_TYPO3_with_DDEV_A_Step_by_Step_Guide/TYPO3_Installation_mit_DDEV_Feature.jpg) Table of content Welcome to our guide to i**nstalling TYPO3 with DDEV**. Here you will find simple instructions for setting up the TYPO3 development environment. In this tutorial, we will show you how to use DDEV. We also explain how you can [**TYPO3 Docker**](https://nitsantech.de/en/blog/typo3-docker)**,** and [**TYPO3 Composer**](https://nitsantech.de/en/blog/typo3-composer) can use. Here's how to set up a local development environment for TYPO3. Whether you're an experienced developer or new to TYPO3, this guide will help you. *Let's get started 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](https://nitsantech.de/en/blog/installing-typo3). If you encounter any issues while installing DDEV, you can seek support on the DDEV Discord server. #### How to Install Docker? Visit to download and install the recommended version of Docker for your operating system. #### How to Install DDEV? Follow the [DDEV installation](https://ddev.readthedocs.io/en/stable/) guide to install DDEV. 1. Open your terminal or command prompt. 2. Create a new directory where you want to [**install TYPO3**](https://nitsantech.de/en/blog/installing-typo3). For example: ```none mkdir t3example cd t3example ``` Now, let's create a new DDEV project for TYPO3 When prompted, provide the following information: ```php 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: ```none ddev config --project-type=typo3 --docroot=public --create-docroot --php-version 8.1 ``` #### Please Note: **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**: If you enable this option, DDEV will create the directory if it does not already exist. This simplifies the setup process. Once the project is configured, start it by running: ```none ddev start ``` **Note**: TYPO3 is not installed yet. To install TYPO3, use Composer by running the following command within your project directory: ```none ddev composer create "typo3/cms-base-distribution:^12" ``` When prompted, confirm that you are allowed to overwrite the files in this directory. To do this, enter “**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](https://nitsantech.de/en/blog/typo3-v12-1-release-notes), you can use a CLI command to set up TYPO3: ```none 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. ```none ddev exec touch public/FIRST_INSTALL ``` **2.Now, open the installer in your browser:** Launch the TYPO3 installer by running: ```none ddev launch typo3/install.php ``` **3.Access the TYPO3 Backend:** After completing the installation, navigate to the [TYPO3 backend](https://nitsantech.de/en/blog/typo3-backend) by entering: ```none 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: ```none 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: ```none ddev launch -m ``` To stop all running DDEV projects, use the following command: ```none ddev poweroff ``` If you need to delete a specific project, navigate to the project's root folder and use the following command: ```none 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**](https://nitsantech.de/en/blog/typo3-website) and applications with ease. At NITSAN, a leading [**TYPO3 Agency**](https://nitsantech.de/en/typo3-agency), we provide expert solutions for TYPO3 development, customization, and support. Need help with your TYPO3 project? Get in touch with us today! Happy TYPO3 development! #### Contact for Internet agency and TYPO3 projects #### Sven Thelemann Service Partner - Germany [ st@nitsantech.de ](mailto:st@nitsantech.de) [ +49 351 48196661 ](tel:4935148196661) ![Sven Thelemann](/fileadmin/ns_theme_nitsan/CTA/SVEN__1_.png "Sven Thelemann") ![](https://nitsantech.de/fileadmin/ns_theme_nitsan/Team_Slider/Sven_Thelemann.png) ### Sven Thelemann Client Service Lead - [](https://www.linkedin.com/in/sven-thelemann-0a30867b/ "linkedin") Sven Thelemann serves as the Client Service Lead at NITSAN, focusing on delivering TYPO3 solutions that meet client goals. With a strong understanding of technology and client expectations, he ensures smooth communication and project execution. Outside of work, Sven enjoys cycling and experimenting with homemade recipes. Comments and Responses ---------------------- Thank you for your comment. Your Comment Added Successfully. Thank you for your comment. Your Comment Will Be Visible After Approval. Oops! Something went wrong, please try again later. ##### **Be the First to Comment** ### Related Blogs [ ![](https://nitsantech.de/data:,) #### TYPO3 CMS for Public Sector Websites: Requirements and Best Practices ](https://nitsantech.de/en/typo3-public-sector-2026) [ ![](https://nitsantech.de/data:,) #### TYPO3 SEO: Improve Your TYPO3 Website Ranking ](https://nitsantech.de/en/blog/typo3-seo)