---
title: "Development environment"
manual: "TYPO3 EXT:tea"
version: "main"
permalink: "https://docs.typo3.org/permalink/ttn/tea:development-environment@main"
source: "Environment.rst"
modified: "2026-09-17T10:16:32+00:00"
---

# Development environment

You can run the code quality checks and automated tests locally (using a
local PHP, Composer, and database) or using runTests.sh.

To kickstart the project, we suggest the usage of the
[TYPO3-testing-distribution](https://github.com/oliverklee/TYPO3-testing-distribution/)
by Oliver Klee as development environment. The distribution comes with a frontend,
example data and predefined plugins.

The following commands expect that your SSH key is known by GitHub. If not, you need to use `https://`.

```bash
git clone git@github.com:oliverklee/TYPO3-testing-distribution.git
```

Please checkout the branch for the TYPO3 version you need. e.g. `12.x`.
For more information about the TYPO3-testing-distribution (e.g. backend user credentials), use the documentation:
[https://github.com/oliverklee-de/TYPO3-testing-distribution/blob/13.x/README.md](https://github.com/oliverklee-de/TYPO3-testing-distribution/blob/13.x/README.md) (TYPO3 13)
Adjust link to your needed version.

```bash
git clone git@github.com:TYPO3BestPractices/tea.git
```

You can organize the folder structure as you wish, but lets say your folder
structure looks like this:

```bash
git\
    TYPO3-testing-distribution
    tea
```

Inside the testing distribution there is a file
`docker-compose.extensions.yaml.template` which mounts the used extensions. This file need to be renamed and adjusted.

```bash
cp .ddev/docker-compose.extensions.yaml.template .ddev/docker-compose.extensions.yaml
```

The file needs to mount the tea extension into the testing distribution. Keep in mind
that you use the correct paths here. You need to edit `docker-compose.extensions.yaml`
and add the following content:

```yaml
services:
  web:
    volumes:
      - "$HOME/git/tea:/var/www/html/src/extensions/tea:cached,ro"
```

> [!NOTE]
> More information about volumes and mounts:
>
> [https://docs.docker.com/reference/compose-file/services/#volumes](https://docs.docker.com/reference/compose-file/services/#volumes)

After that you can start the testing distribution using ddev (inside the TYPO3-testion-distribution folder).

```bash
ddev start
ddev composer install
ddev install-typo3
ddev db-import
```

After that you should be able to access the frontend:

```bash
ddev launch
```

Remember you can find all credentials (backend/frontend) here:

[https://github.com/oliverklee-de/TYPO3-testing-distribution/blob/13.x/README.md#credentials](https://github.com/oliverklee-de/TYPO3-testing-distribution/blob/13.x/README.md#credentials) (TYPO3 13)