morsalin1342/frankenphp repository overview

⁠FrankenPHP — Production-Ready PHP App Server with Custom Caddy Builds

Maintained by morsalin1342⁠ · GitHub⁠

FrankenPHP is a modern PHP app server built in Go. This image bundles a custom-compiled Caddy web server, 51 PHP extensions, and essential CLI tools — everything you need to run production PHP applications in a single container.

⁠✨ Why This Image?

⁠Quick Start

# docker-compose.yml
services:
  app:
    image: morsalin1342/frankenphp:8.4
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      - ./public:/app
      - ./Caddyfile:/etc/caddy/Caddyfile

# Caddyfile
:80 {
    root * /app
    encode zstd gzip
    php_server
    file_server
}

⁠Available Tags

Only Debian 13 (trixie) is built, and -trixie tags are aliases of the unsuffixed ones. The old -bookworm tags stay available but are no longer updated.

⁠What's Included

The full list of extensions and tools, with versions, is in EXTENSIONS.md⁠.

• Custom Caddy with the OWASP Coraza WAF (CRS compiled in), rate limiting, AI-crawler blocking, Brotli, HTTP cache (Souin), and 6 DNS challenge providers
• 51 PHP extensions: Redis, MongoDB, PostgreSQL, Imagick, GD, Intl, OpenTelemetry, and more
• Tools: Composer, WP-CLI, Node.js 24, the MariaDB client, FFmpeg

⁠Customizing

FROM morsalin1342/frankenphp:8.4
RUN install-php-extensions xdebug
COPY php.ini /usr/local/etc/php/php.ini

⁠❓ FAQ

Q: Can I add extensions? A: Yes — RUN install-php-extensions <name> in a layer on top; the installer is already in the image.

Q: How do I run queue workers? A: Run them as separate containers from the same image with their own command; supervisor and cron are not included.

Q: Is there a bookworm image? A: No. Only trixie is built now. Older -bookworm tags stay on Docker Hub but are no longer updated.

⁠🔗 Related Images & Tools

⭐ If this image helps you, consider giving it a star on GitHub⁠!