# 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 worker mode, automatic HTTPS, HTTP/2, and HTTP/3 support. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5264/frankenphp

## Description

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.

## Health score

80/100 (Excellent), based on 4 of 5 factors.
- Maintained: 100 (last commit 3 days ago)
- Popular: 81 (11,543 GitHub stars)
- Easy to install: 25 (0 install platforms, install notes, Docker image)
- Security check: 94 (no serious findings, 1 minor, CI, tests)

## Links

- GitHub: https://github.com/php/frankenphp
- Docker Hub: https://hub.docker.com/r/shinsenter/frankenphp
- Official website: https://frankenphp.dev

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/5264/frankenphp), the self-hosted and open-source app directory.
