shinsenter/frankenphp repository overview

⁠shinsenter/frankenphp

🧟 (PHP) FrankenPHP with HTTPS built in, ready for production

• Docker Hub: https://hub.docker.com/r/shinsenter/frankenphp⁠
• GitHub Packages: https://code.shin.company/php/pkgs/container/frankenphp⁠
• Main documentation (all environment variables, PHP extensions, hooks, cron): shinsenter/php⁠
• Other pre-built images for popular PHP apps and frameworks: https://hub.docker.com/u/shinsenter⁠

⁠Quick start

docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v ./myproject:/var/www/html \
    shinsenter/frankenphp:latest

Open http://localhost⁠ (or https://localhost⁠ with the test certificate). Your code lives in /var/www/html. If you mount an empty folder, the container can create a project for you: set INITIAL_PROJECT, for example -e INITIAL_PROJECT=laravel/laravel.

The images include the latest Composer⁠. PHP settings change through PHP_* environment variables, so you do not need to rebuild the image.

Need a specific PHP version? See the tags on Docker Hub⁠. For a plain PHP image without FrankenPHP, see shinsenter/php⁠.

⁠Common settings

Pass them with -e NAME=value or in environment: of your compose file.

The full list (cron, SSH, autorun switches) is in the shinsenter/php⁠ documentation.

⁠HTTPS

The image ships a self-signed certificate for local tests:

• /etc/ssl/site/server.crt
• /etc/ssl/site/server.key

For production, replace both files with your own, by mounting them:

services:
  web:
    image: shinsenter/frankenphp:latest
    volumes:
      - ./myproject:/var/www/html
      - ./my_domain.crt:/etc/ssl/site/server.crt
      - ./my_domain.key:/etc/ssl/site/server.key

or by copying them in your own Dockerfile:

FROM shinsenter/frankenphp:latest
COPY my_domain.crt /etc/ssl/site/server.crt
COPY my_domain.key /etc/ssl/site/server.key

⁠Extend the image

FROM shinsenter/frankenphp:latest

# Your own steps, for example:
ADD --chown=$APP_USER:$APP_GROUP ./myproject/ /var/www/html/

Adding PHP extensions, hooks, autorun scripts and cron jobs are covered in shinsenter/php⁠.

⁠Image tags and platforms

• All tags and platforms: Docker Hub⁠. Debian and Alpine variants are available.
• Since 2026-10-25, linux/386, linux/arm/v7, linux/ppc64le and linux/s390x are no longer built. Older tags keep them until they are rebuilt.
• Images are rebuilt when PHP, the base OS or Composer publish an update, so a tag can change over time. For production, pin your own copy:

docker pull shinsenter/frankenphp:latest
docker tag  shinsenter/frankenphp:latest your-repo/frankenphp:stable
docker push your-repo/frankenphp:stable

⁠Support the project

Keeping these images rebuilt for every PHP release takes ongoing work. If they save you time, you can help keep them going:

• ☕ Donate via PayPal⁠
• 💖 Sponsor on GitHub⁠

Reporting a bug, sharing the project or giving it a star on GitHub⁠ also helps.

⁠Issues and license

• Questions and bugs: GitHub issues⁠.
• Licensed under the GNU General Public License v3.0⁠. If you reuse ideas from this project, please give credit.

From Vietnam 🇻🇳 with love.