Base Image

typo3incubator/typo3-base is a slim runtime image with PHP-FPM and all required PHP extensions for TYPO3. It does not contain TYPO3 itself — you build your project-specific image on top of it.

Variants

Two variants are available:

VariantPortsProcessesUse Case
-nginx80Nginx + PHP-FPM (Supervisor)Docker Compose, simple deploys
-fpm9000PHP-FPM onlyKubernetes, CI, external web server

Available Tags

TagPHPVariantDescription
8.2-nginx8.2NginxMinimum for TYPO3 v13
8.2-fpm8.2FPM
8.3-nginx8.3NginxRecommended
8.3-fpm8.3FPM
8.4-nginx8.4NginxLatest PHP
8.4-fpm8.4FPM
latest8.3NginxAlias for 8.3-nginx

Usage — Nginx Variant (all-in-one)

# syntax=docker/dockerfile:1
FROM ghcr.io/typo3incubator/typo3-base:8.3-nginx AS base
FROM composer:2 AS build

WORKDIR /app
COPY composer.json composer.lock ./
RUN composer install --no-dev --prefer-dist --optimize-autoloader --no-scripts
COPY . .
RUN composer dump-autoload --optimize --no-dev

FROM base
COPY --from=build --chown=typo3:typo3 /app /var/www/html

Usage — FPM Variant (Kubernetes / external web server)

FROM ghcr.io/typo3incubator/typo3-base:8.3-fpm
COPY --from=build --chown=typo3:typo3 /app /var/www/html

Pair with an Nginx, Caddy, or Traefik container as a sidecar or reverse proxy.

Relationship to DDEV

These images complement DDEV — they do not compete with it.

Use CaseRecommended Tool
Local developmentDDEV
Team developmentDDEV
CI/CD pipelinestypo3incubator/typo3-base (fpm variant)
Staging & productiontypo3incubator/typo3-base (with your project)
Kubernetes / Cloudtypo3incubator/typo3-base (fpm variant) + Helm Charts
Demo & evaluationtypo3/demo
TYPO3 Core contributiontypo3/contrib