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…
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
Variants
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
- FrankenPHP: the modern PHP app server : r/PHP - Reddit (reddit)
- FrankenPHP, an app server for PHP written in Go: worker mode ... - Reddit (reddit)
- FrankenPHP: an app server for PHP written in Go - Reddit (reddit)
- New FrankenPHP feature: package your PHP apps as standalone ... - Reddit (reddit)
- We are embracing FrankenPHP! : r/PHP - Reddit (reddit)
- GitHub - dunglas/frankenphp: The modern PHP app server - Reddit (reddit)
Collected 48 days ago - public community threads