FrankenPHP

FrankenPHP is a modern PHP application server built on Caddy, provided as production and development Docker images that help PHP developers run apps with…

  • Development
  • Tools & Utilities
FrankenPHP is a modern PHP application server built on Caddy, provided as production and development Docker images that help PHP developers run apps with worker mode, automatic HTTPS, HTTP/2, and HTTP/3 support.

Platform availability

Available on 0 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

80/100 Excellent

Maintained
100last commit 3 days ago
Popular
8111,543 GitHub stars
Easy to install
250 install platforms, install notes, Docker image
Light to run
No data
Security check
94no serious findings, 1 minor, CI, tests

Based on 4 of 5 factors.

GitHub stars
11,543
Open issues
137
Last commit
2026-11-18
Latest release
v1.13.5
License
MIT
Activity
rising

Checked 3 days ago - source: GitHub (php/frankenphp)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Launch FrankenPHP with Docker Compose In your app folder, run `docker compose up --wait`; Docker Compose (a helper that starts a packaged Docker app from a config file) will start FrankenPHP and wait until it is ready, so if you skip it the app won't be running and your site won't load. source
  • Add missing PHP extensions in Docker In your Dockerfile (the recipe that builds the app's container), use `install-php-extensions` to add PHP features your app needs, such as `pdo_mysql` or `gd`. Without them, the app may start but pages can fail with missing-extension errors. source
  • Open web ports when using Docker image If you run the Docker image (the packaged app) directly, expose port 80 for normal web traffic and 443 for HTTPS, with 443/udp helping enable HTTP/3. Without these ports open, other devices or a router can't reach the site. source

Fetched 53 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Why won’t my FrankenPHP site load after starting it with Docker Compose?

In your app folder, run `docker compose up --wait`. Docker Compose starts FrankenPHP and waits until it is ready. If you skip the wait, the app won’t be running and your site won’t load.

How do I add missing PHP extensions to the FrankenPHP Docker image?

In your Dockerfile, use `install-php-extensions` to add the PHP extensions your app needs, such as `pdo_mysql` or `gd`. Without them, the app may start but pages can fail with missing-extension errors.

Which ports should I expose when running the FrankenPHP Docker image directly?

Expose port 80 for normal web traffic and port 443 for HTTPS. Port 443/udp can also help enable HTTP/3. If these ports are not open, other devices or your router can’t reach the site.

What should I do if I cannot access https://127.0.0.1 from the host machine?

Start FrankenPHP in debug mode. This helps you figure out the problem.

Answers sourced from frankenphp.dev, frankenphp.dev, frankenphp.dev, frankenphp.dev

Community

Collected 48 days ago - public community threads