| name | typo3-ddev |
| description | Agent Skill: DDEV setup for TYPO3 extension development. Use when setting up local dev environment or multi-version testing (11.5/12.4/13.4/14.0). By Netresearch. |
TYPO3 DDEV Setup Skill
Automates DDEV environment for TYPO3 extension development with multi-version testing.
When to Use
- Setting up DDEV for a TYPO3 extension project
- Testing extension across multiple TYPO3 versions
- Quick development environment spin-up
Container Priority
Always check for existing containers first:
- Check
.ddev/exists → useddev exec - Check
docker-compose.ymlexists → usedocker compose exec - Only use system tools if no container environment
Critical: Use the project's configured PHP version, not system PHP.
Quick Start
scripts/validate-prerequisites.sh # Check Docker, DDEV
ddev start
ddev install-all # All versions (11/12/13/14)
ddev install-v13 # Single version
Access URLs
| Environment | URL |
|---|---|
| TYPO3 v13 | https://v13.{sitename}.ddev.site/typo3/ |
| Docs | https://docs.{sitename}.ddev.site/ |
Credentials: admin / Joh316!
Generated Files
.ddev/
├── config.yaml
├── docker-compose.web.yaml
├── apache/apache-site.conf
└── commands/web/install-v{11,12,13,14}
Optional Commands
ddev generate-makefile # Creates make up/test/lint/ci
ddev generate-index # Overview dashboard
ddev docs # Render Documentation/*.rst
Troubleshooting
| Issue | Solution |
|---|---|
| Database exists | ddev mysql -e "DROP DATABASE v13; CREATE DATABASE v13;" |
| Extension not appearing | ddev exec -d /var/www/html/v13 vendor/bin/typo3 cache:flush |
References
| Topic | File |
|---|---|
| Prerequisites | references/prerequisites-validation.md |
| Quick start | references/quickstart.md |
| Advanced options | references/advanced-options.md |
| Windows fixes | references/windows-fixes.md |
| Troubleshooting | references/troubleshooting.md |
| PHP version management | references/0003-php-version-management.md |
Contributing: https://github.com/netresearch/typo3-ddev-skill