frankenphp (sha256:08de484067687c6d7218730f3d377ec99073942e4e9b44369afed76c9a7bbc7d)

Published 2026-07-15 01:35:10 -07:00 by jesscarlos in jesscarlos/frankenphp

Pull the image from the command line:

docker pull forge.jesscarlos.com/jesscarlos/frankenphp@sha256:08de484067687c6d7218730f3d377ec99073942e4e9b44369afed76c9a7bbc7d

Digest

sha256:08de484067687c6d7218730f3d377ec99073942e4e9b44369afed76c9a7bbc7d

For more information on the Container registry, see the documentation.

The modern PHP app server

# debian.sh --arch 'amd64' out/ 'bookworm' '@1783900800'

RUN /bin/sh -c set -eux; { echo 'Package: php*'; echo 'Pin: release *'; echo 'Pin-Priority: -1'; } > /etc/apt/preferences.d/no-debian-php # buildkit

ENV PHPIZE_DEPS=autoconf dpkg-dev file g++ gcc libc-dev make pkg-config re2c

RUN /bin/sh -c set -eux; apt-get update; apt-get install -y --no-install-recommends $PHPIZE_DEPS ca-certificates curl xz-utils ; rm -rf /var/lib/apt/lists/* # buildkit

ENV PHP_INI_DIR=/usr/local/etc/php

RUN /bin/sh -c set -eux; mkdir -p "$PHP_INI_DIR/conf.d"; [ ! -d /var/www/html ]; mkdir -p /var/www/html; chown www-data:www-data /var/www/html; chmod 1777 /var/www/html # buildkit

ENV PHP_CFLAGS=-fstack-protector-strong -fpic -fpie -O2 -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64

ENV PHP_CPPFLAGS=-fstack-protector-strong -fpic -fpie -O2 -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64

ENV PHP_LDFLAGS=-Wl,-O1 -pie

ENV GPG_KEYS=AFD8691FDAEDF03BDF6E460563F15A9B715376CA 9D7F99A0CB8F05C8A6958D6256A97AF7600A39A6 0616E93D95AF471243E26761770426E17EBBB3DD

ENV PHP_VERSION=8.4.23

ENV PHP_URL=https://www.php.net/distributions/php-8.4.23.tar.xz PHP_ASC_URL=https://www.php.net/distributions/php-8.4.23.tar.xz.asc

ENV PHP_SHA256=1ab9f52008414e43bb2427ffa288eff2a4de39e1a830f957e800ba368d887a72

RUN /bin/sh -c set -eux; savedAptMark="$(apt-mark showmanual)"; apt-get update; apt-get install -y --no-install-recommends gnupg; rm -rf /var/lib/apt/lists/*; mkdir -p /usr/src; cd /usr/src; curl -fsSL -o php.tar.xz "$PHP_URL"; if [ -n "$PHP_SHA256" ]; then echo "$PHP_SHA256 *php.tar.xz" | sha256sum -c -; fi; curl -fsSL -o php.tar.xz.asc "$PHP_ASC_URL"; export GNUPGHOME="$(mktemp -d)"; for key in $GPG_KEYS; do gpg --batch --keyserver keyserver.ubuntu.com --recv-keys "$key"; done; gpg --batch --verify php.tar.xz.asc php.tar.xz; gpgconf --kill all; rm -rf "$GNUPGHOME"; apt-mark auto '.*' > /dev/null; apt-mark manual $savedAptMark > /dev/null; apt-get purge -y --auto-remove -o APT::AutoRemove::RecommendsImportant=false # buildkit

COPY docker-php-source /usr/local/bin/ # buildkit

RUN /bin/sh -c set -eux; savedAptMark="$(apt-mark showmanual)"; apt-get update; apt-get install -y --no-install-recommends libargon2-dev libcurl4-openssl-dev libonig-dev libreadline-dev libsodium-dev libsqlite3-dev libssl-dev libxml2-dev zlib1g-dev ; export CFLAGS="$PHP_CFLAGS" CPPFLAGS="$PHP_CPPFLAGS" LDFLAGS="$PHP_LDFLAGS" PHP_BUILD_PROVIDER='https://github.com/docker-library/php' PHP_UNAME='Linux - Docker' ; docker-php-source extract; cd /usr/src/php; gnuArch="$(dpkg-architecture --query DEB_BUILD_GNU_TYPE)"; debMultiarch="$(dpkg-architecture --query DEB_BUILD_MULTIARCH)"; if [ ! -d /usr/include/curl ]; then ln -sT "/usr/include/$debMultiarch/curl" /usr/local/include/curl; fi; test "$PHP_INI_DIR" != "${PHP_INI_DIR%/php}"; ./configure --build="$gnuArch" --sysconfdir="${PHP_INI_DIR%/php}" --with-config-file-path="$PHP_INI_DIR" --with-config-file-scan-dir="$PHP_INI_DIR/conf.d" --enable-option-checking=fatal --with-mhash --with-pic --enable-mbstring --enable-mysqlnd --with-password-argon2 --with-sodium=shared --with-pdo-sqlite=/usr --with-sqlite3=/usr --with-curl --with-iconv --with-openssl --with-readline --with-zlib --enable-phpdbg --enable-phpdbg-readline --with-pear --with-libdir="lib/$debMultiarch" --enable-embed --enable-zts --disable-zend-signals ; make -j "$(nproc)"; find -type f -name '*.a' -delete; make install; find /usr/local -type f -perm '/0111' -exec sh -euxc ' strip --strip-all "$@" || : ' -- '{}' + ; make clean; cp -v php.ini-* "$PHP_INI_DIR/"; cd /; docker-php-source delete; apt-mark auto '.*' > /dev/null; [ -z "$savedAptMark" ] || apt-mark manual $savedAptMark; find /usr/local -type f -executable -exec ldd '{}' ';' | awk '/=>/ { so = $(NF-1); if (index(so, "/usr/local/") == 1) { next }; gsub("^/(usr/)?", "", so); printf "*%s\n", so }' | sort -u | xargs -rt dpkg-query --search | awk 'sub(":$", "", $1) { print $1 }' | sort -u | xargs -r apt-mark manual ; apt-get purge -y --auto-remove -o APT::AutoRemove::RecommendsImportant=false; rm -rf /var/lib/apt/lists/*; pecl update-channels; rm -rf /tmp/pear ~/.pearrc; php --version # buildkit

COPY docker-php-ext-* docker-php-entrypoint /usr/local/bin/ # buildkit

RUN /bin/sh -c docker-php-ext-enable opcache # buildkit

RUN /bin/sh -c docker-php-ext-enable sodium # buildkit

ENTRYPOINT ["docker-php-entrypoint"]

CMD ["php" "-a"]

WORKDIR /app

RUN /bin/sh -c apt-get update && apt-get -y --no-install-recommends install mailcap libcap2-bin && apt-get clean && rm -rf /var/lib/apt/lists/* # buildkit

RUN /bin/sh -c set -eux; mkdir -p /app/public /config/caddy /data/caddy /etc/caddy /etc/frankenphp; sed -i 's/php/frankenphp run/g' /usr/local/bin/docker-php-entrypoint; echo '<?php phpinfo();' > /app/public/index.php # buildkit

COPY caddy/frankenphp/Caddyfile /etc/caddy/Caddyfile # buildkit

RUN /bin/sh -c ln /etc/caddy/Caddyfile /etc/frankenphp/Caddyfile && curl -sSLf -o /usr/local/bin/install-php-extensions https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions && chmod +x /usr/local/bin/install-php-extensions # buildkit

CMD ["--config" "/etc/frankenphp/Caddyfile" "--adapter" "caddyfile"]

HEALTHCHECK {Test:[CMD-SHELL curl -f http://localhost:2019/metrics || exit 1] Interval:0s Timeout:0s StartPeriod:0s StartInterval:0s Retries:0}

ENV XDG_CONFIG_HOME=/config

ENV XDG_DATA_HOME=/data

EXPOSE [80/tcp]

EXPOSE [443/tcp]

EXPOSE [443/udp]

EXPOSE [2019/tcp]

LABEL org.opencontainers.image.title=FrankenPHP

LABEL org.opencontainers.image.description=The modern PHP app server

LABEL org.opencontainers.image.url=https://frankenphp.dev

LABEL org.opencontainers.image.source=https://github.com/php/frankenphp

LABEL org.opencontainers.image.licenses=MIT

LABEL org.opencontainers.image.vendor=Kévin Dunglas

ENV GODEBUG=cgocheck=0

COPY /usr/local/lib/libwatcher* /usr/local/lib/ # buildkit

RUN /bin/sh -c apt-get install -y --no-install-recommends libstdc++6 && apt-get clean && ldconfig # buildkit

COPY /usr/local/bin/frankenphp /usr/local/bin/frankenphp # buildkit

RUN /bin/sh -c setcap cap_net_bind_service=+ep /usr/local/bin/frankenphp && frankenphp version && frankenphp build-info # buildkit

ARG GID

ARG GID GROUP

ARG GID GROUP UID

ARG GID GROUP UID USER

ENV CADDY_CONFIG=/etc/frankenphp/Caddyfile

ENV FRANKENPHP_HOST=0.0.0.0

ENV FRANKENPHP_PORT=8000

WORKDIR /var/www/html

HEALTHCHECK NONE

|4 GID=1500 GROUP=dockge_admin UID=2000 USER=gil /bin/sh -c apt-get update && apt-get install -y fswatch nano tini

|4 GID=1500 GROUP=dockge_admin UID=2000 USER=gil /bin/sh -c <<-EOF groupadd -g ${GID} ${GROUP} useradd -u ${UID} -g ${GROUP} -m ${USER} # Add additional capability to bind to port 80 and 443 setcap CAP_NET_BIND_SERVICE=+eip /usr/local/bin/frankenphp # create directories mkdir -p /config/caddy /data/caddy # Give write access to /config/caddy and /data/caddy chown -R ${USER}:${GROUP} /config/caddy /data/caddy /etc/frankenphp /var/www/html

|4 GID=1500 GROUP=dockge_admin UID=2000 USER=gil /bin/sh -c install-php-extensions pcntl zip

COPY file:00a69f5590cf526b63dd6a4db6fdd42005c040d6feebdd59610f357cd85c96a1 in /usr/local/bin/entrypoint

COPY file:59510d132b314c2a5554890c271ee7c21cd942dbe5c591e37fc4981c3d93ef68 in /etc/frankenphp/Caddyfile

|4 GID=1500 GROUP=dockge_admin UID=2000 USER=gil /bin/sh -c chmod +x /usr/local/bin/entrypoint

ENTRYPOINT [ "entrypoint" ]

USER ${USER}:${GROUP}

EXPOSE 80

Key	Value
dev.frankenphp.base.fingerprint	63ede5882ac4f39598d678352de7b89ae3c820b2e110cce5cf79bedeee5f2d4e
io.buildah.version	1.43.2
org.opencontainers.image.created	2026-07-15T04:58:42Z
org.opencontainers.image.description	The modern PHP app server
org.opencontainers.image.licenses	MIT
org.opencontainers.image.revision	118799465336663c5821364859229f4a3a1bdcd6
org.opencontainers.image.source	https://github.com/php/frankenphp
org.opencontainers.image.title	FrankenPHP
org.opencontainers.image.url	https://frankenphp.dev
org.opencontainers.image.vendor	Kévin Dunglas
org.opencontainers.image.version	v1.12.4