TYPO3 Official Docker Images

Production-ready Docker images for TYPO3 CMS — Debian Trixie + PHP (Sury packages). Multi-architecture support: linux/amd64 + linux/arm64 (Apple Silicon).

Full Documentation

Images

Image	Purpose	Quick Start
typo3incubator/typo3-base	Slim runtime — build your project on top	Base Image Docs
typo3/demo	Pre-installed TYPO3 for demos	docker compose -f docker-compose.demo.yml up
typo3/contrib	TYPO3 Core contribution environment	Contrib Docs

Quick Start

docker compose -f docker-compose.demo.yml up

Service	URL
Frontend	http://localhost:8080
Backend	http://localhost:8080/typo3
Mailpit	http://localhost:8025

Admin credentials are randomly generated on first run — check docker compose -f docker-compose.demo.yml logs setup.

Architecture

debian:trixie-slim + Sury PHP
         |
    [php-base]  <- shared stage (PHP + extensions + Composer + GraphicsMagick)
     /        \
  [fpm]      [nginx]
:8.3-fpm   :8.3-nginx  <- build targets (--target fpm / --target nginx)
    |         |
    |   Dockerfile.demo    -> typo3/demo:{TYPO3_VERSION}
    |
Dockerfile.contrib -> typo3/contrib:{PHP_VERSION}

Building Locally

make build-all    # Build everything (base + demo + contrib)
make test         # Run smoke tests (nginx variant)
make test-fpm     # Run smoke tests (fpm variant)
make demo         # Build and start demo

See the full documentation for environment variables, production deployment with Traefik SSL, Kubernetes guides, and more.

Contributing

See CONTRIBUTING.md for build instructions and development setup.

Based on prior work by Martin Helmich (docker-typo3, docker-typo3-cloud). Environment mapping pattern inspired by André Buchmann's TYPO3 distribution template.

License

GPL-3.0-or-later