Problem making a static build in Docker

[rikgriffin]

Hi all,

I'm trying to use the instructions here: https://frankenphp.dev/docs/static/ to build a standalone FrakenPHP binary.

Build environment is openSUSE 15.5 with Docker 28.5.0.

Here's what I did:

git clone https://github.com/php/frankenphp.git

This is the script I'm running to do the build:

PHP_EXTENSIONS='ctype,gd,ldap,libxml,pdo_sqlite,sysvmsg,sysvsem,sysvshm,posix,sockets,openssl,mbstring,dom'
PHP_EXTENSION_LIBS='libjpeg,libwebp'
GITHUB_TOKEN=`cat github-token`

docker buildx bake --load static-builder-musl

docker run --rm -v "$PWD/output:/output" -e OUTPUT_DIR=/output -e GITHUB_TOKEN=$GITHUB_TOKEN -e PHP_EXTENSIONS=$PHP_EXTENSIONS -e PHP_EXTENSION_LIBS=$PHP_EXTENSION_LIBS -e SPC_LOGS_DIR=/output/log dunglas/frankenphp:static-builder-musl

It all seems to go ok until the (presumably) last stage:

  ⠏ Building package: frankenphp (< 1 ms)
  ⠏ Building frankenphp: processing --with-frankenphp-app option (< 1 ms)
  ⠏ Building frankenphp: building with xcaddy (< 1 ms)
  ✘ Building package failed: frankenphp (4 s)


✘ Command execution failed: Command exited with non-zero code: 1

Looking in output/log/spc.shell.log shows this near the end:

2026/10/23 07:27:00 [INFO] exec (timeout=0s): /opt/spc-pkgroot/go-xcaddy/bin/go get -buildmode=pie -ldflags -linkmode=external -extldflags '-static-pie -Wl,-z,stack-size=0x80000 -Wl,-exported_symbols_list,/go/src/app/dist/buildroot/lib/libphp.a.dynsym -Wl,-z,relro -Wl,--as-needed -Wl,-z,now -Wl,-z,noexecstack -Wl,--gc-sections' -X 'github.com/caddyserver/caddy/v2/modules/caddyhttp.ServerHeader=FrankenPHP Caddy' -X 'github.com/caddyserver/caddy/v2.CustomBinaryName=frankenphp' -X 'github.com/caddyserver/caddy/v2.CustomVersion=FrankenPHP v1.13.2 PHP 8.4.27 Caddy' -tags=static_build,nobadger,nomysql,nopgx,deprecated_topic,deprecated_claim -v github.com/dunglas/frankenphp github.com/caddyserver/caddy/v2 
go: github.com/dunglas/frankenphp@v1.13.2 found: module /go/src/app: reading /go/src/app/go.mod: open /go/src/app/go.mod: no such file or directory
go: github.com/dunglas/frankenphp@upgrade (v1.13.2) requires github.com/dunglas/frankenphp@v1.13.2: module /go/src/app: reading /go/src/app/go.mod: open /go/src/app/go.mod: no such file or directory
2026/10/23 07:27:01 [FATAL] exit status 1

This is probably a silly mistake I've made due to being totally unfamiliar with Docker, can any one advise please?

Many thanks.

[dfbustosus]

This does not look like a normal bind-mount mistake. The command matches the documented static build command, and the builder image copies the repository to /go/src/app. The /output mount cannot hide /go/src/app/go.mod.

caddy/go.mod contains a local replacement pointing back to ../, so the error literally means that /go/src/app/go.mod was absent when xcaddy ran. First verify the exact local image and its contents:

docker image inspect dunglas/frankenphp:static-builder-musl \
  --format "{{index .Config.Labels \"org.opencontainers.image.revision\"}} {{index .Config.Labels \"org.opencontainers.image.version\"}}"

docker run --rm --entrypoint /bin/bash \
  dunglas/frankenphp:static-builder-musl \
  -lc "ls -l /go/src/app/go.mod /go/src/app/caddy/go.mod"

There is another clue: the log reports PHP 8.4.27, while the v1.13.2 craft.yml requests PHP 8.5, and your command does not override PHP_VERSION. That makes a stale or different local image worth ruling out. Rebuild without reusing the old builder:

docker buildx bake --pull --no-cache --load static-builder-musl

The build script also downloads an unpinned nightly static-php-cli binary, so if both go.mod files exist before the build and the clean rebuild still fails, this is likely an upstream builder regression rather than Docker usage. In that case, please attach the complete output/log/spc.shell.log, the image revision above, and the spc version so the failing combination can be reproduced.