Skip to content

Available Images

Available Images

Complete reference of all available Cbox base image tags and variants.

V2 is an unpublished candidate. Size estimates below are v1 reference figures, not measured v2 download sizes; local uncompressed sizes are recorded separately during validation.

Image Registry

All images are published to GitHub Container Registry:

ghcr.io/cboxdk/php-baseimages/{image-type}:{tag}

Image Tiers

All images come in four tiers to match your needs:

Tier Tag Suffix Size (Debian 13) Best For
Slim -slim ~120 MiB APIs, microservices
Standard (none) ~250 MiB Most apps (DEFAULT)
Chromium -chromium ~700 MiB Browsershot, Dusk, PDF
Dev -dev ~750 MiB Chromium + Xdebug, PCOV, SPX

Multi-Service Images (PHP-FPM + Nginx)

Single container with both PHP-FPM and Nginx - perfect for simple deployments.

Standard Tier (Default)

Image Tag PHP OS Size Architecture
php-fpm-nginx:8.5-trixie 8.5 Debian 13 ~250 MiB amd64, arm64
php-fpm-nginx:8.4-trixie 8.4 Debian 13 ~250 MiB amd64, arm64
php-fpm-nginx:8.3-trixie 8.3 Debian 13 ~250 MiB amd64, arm64
php-fpm-nginx:8.2-trixie 8.2 Debian 13 ~250 MiB amd64, arm64

Slim Tier

Optimized for APIs and microservices with minimal footprint:

Image Tag PHP OS Size Architecture
php-fpm-nginx:8.5-trixie-slim 8.5 Debian 13 ~120 MiB amd64, arm64
php-fpm-nginx:8.4-trixie-slim 8.4 Debian 13 ~120 MiB amd64, arm64
php-fpm-nginx:8.3-trixie-slim 8.3 Debian 13 ~120 MiB amd64, arm64
php-fpm-nginx:8.2-trixie-slim 8.2 Debian 13 ~120 MiB amd64, arm64

Chromium Tier

Includes Chromium for Browsershot, Dusk, and PDF generation:

Image Tag PHP OS Size Architecture
php-fpm-nginx:8.5-trixie-chromium 8.5 Debian 13 ~700 MiB amd64, arm64
php-fpm-nginx:8.4-trixie-chromium 8.4 Debian 13 ~700 MiB amd64, arm64
php-fpm-nginx:8.3-trixie-chromium 8.3 Debian 13 ~700 MiB amd64, arm64
php-fpm-nginx:8.2-trixie-chromium 8.2 Debian 13 ~700 MiB amd64, arm64

Rootless Variants

All tiers support rootless execution (runs as www-data user). Available for all PHP versions:

Image Tag Tier Description
php-fpm-nginx:{version}-trixie-rootless Standard Default + rootless
php-fpm-nginx:{version}-trixie-slim-rootless Slim Slim + rootless
php-fpm-nginx:{version}-trixie-chromium-rootless Chromium Chromium + rootless
php-fpm-nginx:{version}-trixie-dev-rootless Dev Dev + rootless

Where {version} is 8.2, 8.3, 8.4, or 8.5.

Tag Format

{type}:{php_version}-{os}[-tier][-rootless][-vN]

Examples:
php-fpm-nginx:8.5-trixie-v2           # Standard tier, release channel (RECOMMENDED)
php-fpm-nginx:8.5-trixie-slim-v2      # Slim tier, release channel
php-fpm-nginx:8.5-trixie-chromium-v2  # Chromium tier, release channel
php-fpm-nginx:8.5-trixie-rootless-v2  # Standard + rootless, release channel
php-fpm-nginx:8.5-trixie              # Standard tier, rolling (follows latest release)
php-fpm-nginx:8.5-trixie-slim-rootless  # Slim + rootless, rolling

Every tag in the matrices above also exists with the -v2 release-channel suffix — that is the variant to pin in production.

Channel tags are rebuilt weekly with OS security patches but never cross a tooling major — your runtime contract stays put, the machine underneath stays patched:

# Behavior pinned to major v2, security patches keep flowing
image: ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.5-trixie-v2

Rolling Tags

Rolling tags also receive weekly security updates, but follow the newest tooling release — including future majors:

# Follows the latest release, rebuilt every Monday
image: ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.5-trixie

Immutable Digests

For byte-exact reproduction, pin the digest (ages by design — it contains the CVEs of its build day):

# Locked to a specific build
image: ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.5-trixie-v2@sha256:abc123...

See Tagging Strategy for the full policy.

Architecture Support

All images are built for multiple architectures:

Architecture Platform Examples
amd64 x86_64 Intel/AMD servers, most cloud VMs
arm64 aarch64 Apple Silicon, AWS Graviton, Raspberry Pi 4+

Docker automatically pulls the correct architecture:

# Works on both AMD64 and ARM64
docker pull ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.5-trixie-v2

OS Information

Cbox PHP Base Images use Debian 13 (Trixie) as the base operating system.

Feature Debian 13 (Trixie)
Base Size ~120 MiB
Package Manager apt-get
libc glibc
Security Updates Weekly
Compatibility Excellent
Best For Production, compatibility

Tier Comparison

Feature Slim Standard Chromium Dev
Size (Debian 13) ~120 MiB ~250 MiB ~700 MiB ~750 MiB
Core Extensions ✅ 25+ ✅ 25+ ✅ 25+ ✅ 25+
ImageMagick ❌ ✅ ✅ ✅
Node.js 22 (+ npm/npx) ❌ ✅ ✅ ✅
Bun ❌ ✅ ✅ ✅
Chromium ❌ ❌ ✅ ✅
Xdebug/PCOV/SPX ❌ ❌ ❌ ✅
Best For APIs, microservices Most apps Browser automation Development, CI/CD

Version Support

PHP Version Status Active Support Until Security Support Until
PHP 8.5 Active 2027-12-31 2029-12-31
PHP 8.4 Active 2026-12-31 2028-12-31
PHP 8.3 Security-only 2025-12-31 2027-12-31
PHP 8.2 Security-only 2024-12-31 2026-12-31

Dates from php.net/supported-versions; the authoritative copy lives in versions.json. Security-only is a normal, supported state — images keep rebuilding weekly until six months after security support ends.

Recommendation: PHP 8.5 for new projects and production.

Usage Examples

Docker CLI

# Pull standard tier (most Laravel/PHP apps)
docker pull ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.5-trixie-v2

# Pull slim tier (APIs, microservices)
docker pull ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.5-trixie-slim-v2

# Pull chromium tier (Browsershot, Dusk)
docker pull ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.5-trixie-chromium-v2

# Run with volume mount
docker run -p 8000:80 -v $(pwd):/var/www/html \
  ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.5-trixie-v2

Docker Compose

services:
  # Standard tier - most Laravel apps
  app:
    image: ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.5-trixie-v2
    ports:
      - "8000:80"
    volumes:
      - ./:/var/www/html

  # Slim tier - API service
  api:
    image: ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.5-trixie-slim-v2
    ports:
      - "8001:80"

  # Chromium tier - PDF generation service
  pdf:
    image: ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.5-trixie-chromium-v2
    environment:
      PHP_MEMORY_LIMIT: "1G"

Dockerfile

# Standard tier for most apps
FROM ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.5-trixie-v2

COPY --chown=www-data:www-data . /var/www/html

RUN composer install --no-dev --optimize-autoloader
# Chromium tier for Browsershot
FROM ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.5-trixie-chromium-v2

COPY --chown=www-data:www-data . /var/www/html

RUN composer install --no-dev --optimize-autoloader

Weekly Security Rebuilds

All images are automatically rebuilt every Monday at 03:00 UTC:

  • Latest upstream PHP patches
  • Latest OS security updates
  • CVE scanning with Trivy
  • Multi-architecture builds

Stay secure: Pull images regularly to get security patches.

# Pull latest security patches
docker pull ghcr.io/cboxdk/php-baseimages/php-fpm-nginx:8.5-trixie-v2
docker-compose up -d --pull always

Need help choosing? See Choosing Your Image