typo3-ddev

Name: typo3-ddev
Author: dirnbauer

github.com/dirnbauerCloud & DevOps33112 installsUpdated 13w ago

About typo3-ddev

typo3-ddev is a skill for setting up and maintaining TYPO3 projects in DDEV containers. It provides version-aware installation guidance, database and PHP options, and verification and troubleshooting steps.

Key features

01Install TYPO3 versions 11–14
02Choose database and PHP settings
03Verify installations with DDEV commands
04Troubleshoot common setup issues

Use cases

01Set up TYPO3 projects in DDEV
02Install a specific TYPO3 version
03Diagnose database, extension, or port issues

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/dirnbauer/webconsulting-skills --skill typo3-ddev

After installing, type/typo3-ddevin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

assets/templates/

.envrc

config.redis.php.example

config.yaml

docker-compose.git-info.yaml

docker-compose.ofelia.yaml.optional

docker-compose.services-redis.yaml.optional

docker-compose.services.yaml.optional

docker-compose.web.yaml

index.html.netresearch.template

index.html.typo3.template

Makefile.template

assets/templates/apache/

apache-site.conf

docs.conf

v11.conf

v12.conf

v13.conf

v14.conf

assets/templates/commands/

install-all

install-v11

install-v12

install-v13

install-v14

assets/templates/commands/host/

docs

pre-start-git-info

setup

assets/templates/commands/web/

configure-extension.optional

generate-index

generate-makefile

install-introduction.optional

assets/templates/homeadditions/

.bashrc_additions.optional

Details

From the project README

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

Comments

Markdown supported

Details

Author: dirnbauer
Repository: dirnbauer/webconsulting-skills
Category: Cloud & DevOps
Installs: 112
GitHub stars: 33

Report

More skills

All skills

lark-apps

open.feishu.cn

732.0k

Develop and host Miaoda (Spark/Miaoda) apps: app creation, local full-stack development, cloud generation and iteration, creative design (UI mockups / interactive prototypes / wireframes / landing pages / dashboards / slide decks / visual exploration), integration of AI-related capabilities, Feishu platform capabilities, or other external capabilities; log/Trace/monitoring metric/PV/UV queries; environment variable management; app collaborators and collaboration permissions; app roles and members; and automation triggers (scheduled / record changes / Webhook / Feishu approvals). Use when users want to develop or create a system, tool, platform, or app; develop locally or in the cloud, modify, deploy, publish, launch, or get a shareable link; create a page or website with HTML and deploy it to Miaoda; design, create a mockup, prototype, wireframe, PPT, deck, or visual exploration; or mention Miaoda/Spark/Miaoda apps (links like `/app/app_xxx` or `/page/<token>`, runtime domains like *.aiforce.cloud), app databases, app file storage, open API Keys, visibility, app collaborators/developer permissions, app roles/role members, production logs, API request volume, error volume, latency, traffic, environment variables, or setting up automation tasks, scheduled triggers, or approval-triggered automation for Miaoda apps. Not for regular cloud drive file uploads (lark-drive), Feishu document editing (lark-doc), or native slide creation (lark-slides).

azure-prepare

github.com/microsoft

571.7k

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

wizard

github.com/mattpocock

571.5k

Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.

azure-ai

github.com/microsoft

571.2k

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.