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, 56 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

bookworm owns the unsuffixed tags; append -trixie for Debian 13.

⁠What's Included

• Custom Caddy with the OWASP Coraza WAF (CRS compiled in), rate limiting, AI-crawler blocking, Brotli, HTTP cache (Souin), and 6 DNS challenge providers
• 56 PHP extensions: Redis, MongoDB, PostgreSQL, Imagick, GD, Intl, AMQP, Kafka, OpenTelemetry, and more
• Tools: Composer, WP-CLI, Node.js 24, Supervisor, Cron, 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: Supervisor is installed. Mount your config into /etc/supervisor/conf.d/.

Q: bookworm or trixie? A: Unsuffixed tags are bookworm. Append -trixie for Debian 13.

⁠🔗 Related Images & Tools

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