TYPO3 DDEV Setup Skill

CRITICAL: URL Scheme

NEVER guess URLs. Read name: from .ddev/config.yaml, then apply subdomain pattern:

https://v{VERSION}.{sitename}.ddev.site/typo3/ — e.g., https://v14.my-ext.ddev.site/typo3/

Landing: https://{sitename}.ddev.site/ · Docs: https://docs.{sitename}.ddev.site/

Each version has an Apache vhost (/var/www/html/v{VERSION}) via additional_hostnames. Never infer URLs from directory listings.

Credentials: admin / Joh316!!

Container Priority

.ddev/ exists → ddev exec
docker-compose.yml → docker compose exec
System tools only if no container. Use project's configured PHP.

In-container file edits: docker cp in, ddev exec — not heredocs/php -r. See references/container-file-editing.md.

Quick Start

ddev start && ddev install-all    # All versions (11/12/13/14)
ddev install-v14                  # v14.3 LTS (default / gold standard)
ddev install-v13                  # v13.4 LTS

Database Selection

MariaDB 10.11 (default) · SQLite (simple, no SQL) · PostgreSQL 16 (GIS) · MySQL 8.0 (Oracle parity). See references/advanced-options.md references/0002-mariadb-default-with-database-alternatives.md.

PHP Management

php_version: "8.3" in config.yaml. Upgrade via .ddev/web-build/Dockerfile (apt-get dist-upgrade). Custom settings: .ddev/php/custom.ini. See references/0003-php-version-management.md.

TYPO3 Version Differences

| | v12 | v13 | v14.3 LTS | |---|---|---|---| | Setup | install:setup --use-existing-database | setup | setup | | Activation | Auto (Composer) | extension:setup | extension:setup | | composer.json | optional | optional | required (classic mode, #108310) | | Default theme | bootstrap-package | bootstrap-package | Camino (#108539) | | Fluid | 2.x | 4.x | 5.x strict (#108148) | | CKEditor | 41–42 | 41–42 | 47 |

See references/typo3-12-cli-changes.md.

Post-Setup Verification

ddev status, ddev describe, ddev exec -d /var/www/html/v13 vendor/bin/typo3 extension:list --active. See references/post-setup-verification.md.

Optional Services & Commands

Valkey 8 (default) or Redis 7: references/0001-valkey-default-with-redis-alternative.md
Ofelia scheduler: TYPO3 scheduler automation
ddev generate-makefile / ddev generate-index / ddev docs
ddev xdebug on · cache flush: see Troubleshooting

Extension Naming

Hyphens for composer (nr-llm), underscores for TYPO3 key (nr_llm). Source: composer.json name.

Troubleshooting

| Issue | Solution | |---|---| | Port conflict | router_http_port: "8080" / router_https_port: "8443" | | Database exists | ddev mysql -e "DROP DATABASE v13; CREATE DATABASE v13;" | | Extension not found | ddev exec -d /var/www/html/v13 vendor/bin/typo3 cache:flush | | Windows health check | Add /phpstatus endpoint with php-fpm.sock | | PCOV/pecl fails | apt-get install php${PHP_VERSION}-pcov | | PHP settings ignored | Place in .ddev/php/custom.ini | | Full cleanup | ddev delete --omit-snapshot --yes then remove Docker volumes |

References

| Topic | File | |---|---| | Prerequisites | references/prerequisites-validation.md | | Quick start | references/quickstart.md | | Advanced options | references/advanced-options.md | | Post-setup | references/post-setup-verification.md | | Branding/landing page | references/index-page-generation.md | | ADR References | references/{0001,0002,0003}-*.md | | Windows | references/windows-fixes.md, references/windows-optimizations.md | | Docs rendering | references/documentation-rendering.md | | Troubleshooting | references/troubleshooting.md |

Credits & Attribution

This skill is based on the excellent work by Netresearch DTT GmbH.

Original repository: https://github.com/netresearch/typo3-ddev-skill

Copyright (c) Netresearch DTT GmbH — Methodology and best practices (MIT / CC-BY-SA-4.0)

Special thanks to Netresearch DTT GmbH for their generous open-source contributions to the TYPO3 community, which helped shape this skill collection. Adapted by webconsulting.at for this skill collection