TYPO3 in a Container

Our goal is to highlight TYPO3-specific challenges while providing an introduction with (hopefully) low entry barriers.

Complexity and Context

Running TYPO3 in a container — especially in production — is a complex topic that requires some general background knowledge. Since we can’t cover every aspect of container infrastructure, we include links to external sources that TYPO3 developers may find helpful.

Community-Maintained Image Used

As of now, there is no official TYPO3 container image. For demonstration purposes, we’ve used the community-maintained image martinhelmich/typo3 to show how TYPO3 can run inside a container.

Local Setup Examples

The TYPO3 Documentation introduces running TYPO3 in a local container setup using a Docker network that includes a MariaDB container and the martinhelmich/typo3 container. This example helps readers get started with exposing ports, enabling container-to-container communication, and mounting volumes: Classic TYPO3 demo installation using Docker only.

Since Docker Compose is commonly used in local development, we also show how to automate those setup steps: Classic TYPO3 demo installation using Docker Compose.

Extending Images and Using Docker in Production

Next, readers learn how to extend an existing image to unlock more flexibility — and take a first step toward creating their own TYPO3 images: Extending the community-maintained Docker image for TYPO3.

We’ve also started a chapter on using Docker in production: Using Docker in production. However the whole section is still experimental and we need YOUR help to improve it.

Help Shape the Future of TYPO3 Container Images

We think the TYPO3 community needs to expand the available container options — from base images with correct system requirements, to more specialized images with preinstalled site packages and example data.

You can help. Share your knowledge on running TYPO3 in containers, test the new documentation, and give us feedback. Your experience can make a real difference.