typo3-ddev

Name: typo3-ddev
Author: netresearch

github.com/netresearchCloud & DevOps844 installsUpdated 3d ago

About typo3-ddev

A setup and troubleshooting skill for TYPO3 projects using DDEV, with guidance for version-specific installation, databases, PHP settings, and verification. It also describes a provisioning path for environments without DDEV.

Key features

01DDEV-based TYPO3 setup
02Version-specific installation steps
03Database and PHP configuration
04Post-setup checks
05Provisioning without DDEV
06Troubleshooting guidance

Use cases

01Setting up TYPO3 versions locally
02Choosing and configuring a database
03Verifying installation and login routes
04Provisioning TYPO3 without DDEV

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/netresearch/typo3-ddev-skill --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 the subdomain pattern:

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

Each version gets a 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.

No DDEV available (CI, container, agent harness — DDEV drives Docker): read .ddev/config.yaml and .ddev/commands/, then scripts/provision-without-ddev.sh --extension . --serve. The distribution ships no .htaccess, so /typo3/ answers 200 while sub-routes 404 — references/without-ddev.md.

In-container edits: docker cp in, then 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 · PostgreSQL 16 · MySQL 8.0. 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. 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	`extension:setup`	`extension:setup`
`composer.json`	optional	optional	required (#108310)
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. Check a consequence, not a status: /typo3/login must answer 200. 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 automation · ddev generate-makefile / generate-index / docs / xdebug on

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	`/phpstatus` endpoint with `php-fpm.sock`
PHP settings ignored	`.ddev/php/custom.ini`
Full cleanup	`ddev delete --omit-snapshot --yes`, remove volumes

References

Topic	File in `references/`
Without DDEV	`without-ddev.md`
Prerequisites, quick start	`{prerequisites-validation,quickstart}.md`
Advanced, post-setup, branding	`{advanced-options,post-setup-verification,index-page-generation}.md`
ADRs · Windows	`{0001,0002,0003}-*.md` · `windows-{fixes,optimizations}.md`
Docs rendering, troubleshooting	`{documentation-rendering,troubleshooting}.md`

Comments

Markdown supported

Details

Author: netresearch
Repository: netresearch/typo3-ddev-skill
Category: Cloud & DevOps
Installs: 44
GitHub stars: 8

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.