How can i add imagick to frankenphp

[Stephan-MC]

Greetings...

Please i've tried various possible means to build frankenphp with imagick extension included in the build to no avail.
Here is my docker file

FROM dunglas/frankenphp:builder AS builder

# Copy xcaddy in the builder image
COPY --from=caddy:builder /usr/bin/xcaddy /usr/bin/xcaddy

# CGO must be enabled to build FrankenPHP
RUN CGO_ENABLED=1 \
  XCADDY_SETCAP=1 \
  XCADDY_GO_BUILD_FLAGS="-ldflags='-w -s' -tags=nobadger,nomysql,nopgx" \
  CGO_CFLAGS=$(php-config --includes) \
  CGO_LDFLAGS="$(php-config --ldflags) $(php-config --libs)" \
  xcaddy build \
  --output /usr/local/bin/frankenphp \
  --with github.com/dunglas/frankenphp=./ \
  --with github.com/dunglas/frankenphp/caddy=./caddy/ \
  --with github.com/dunglas/caddy-cbrotli \
  # Mercure and Vulcain are included in the official build, but feel free to remove them
  --with github.com/dunglas/mercure/caddy \
  --with github.com/dunglas/vulcain/caddy
# Add extra Caddy modules here

FROM dunglas/frankenphp:latest AS runner

# add additional extensions here:
RUN install-php-extensions \
  pdo_mysql \
  gd \
  intl \
  imagick \
  zip \
  opcache

# Replace the official binary by the one contained your custom modules
COPY --from=builder /usr/local/bin/frankenphp /usr/local/bin/frankenphp

[withinboredom]

It would be helpful to include the error or issue you're running into.

[henderkes]

I assume it's because our newest Docker image is php 8.5 while imagick (among like 20 other common extensions) is not compatible with it yet. Remi has working pull requests for them and ships those instead of the released versions, but it seems the docker extension installer just builds from source.

Can be fixed by installing imagick@master in this case, I believe. If not, you'll have to find a commit hash that works or just revert to php 8.4.

[bukka]

I realeased imagick 3.8.1 few days ago (2025-11-26) which is compatible with 8.5

[henderkes]

Perfect, I'll add it back to my packages. Looks like igbinary also had (pre-) release tagged.

[Stephan-MC]

After thourough research, i found out i need to install imagemagick in the system for the php imagick extension to work. So i updated the Dockerfile to install imagemagick and libmagickwand as system dependencies before installing the extensions.

FROM dunglas/frankenphp:builder AS builder

# Copy xcaddy in the builder image
COPY --from=caddy:builder /usr/bin/xcaddy /usr/bin/xcaddy

# CGO must be enabled to build FrankenPHP
RUN CGO_ENABLED=1 \
  XCADDY_SETCAP=1 \
  XCADDY_GO_BUILD_FLAGS="-ldflags='-w -s' -tags=nobadger,nomysql,nopgx" \
  CGO_CFLAGS=$(php-config --includes) \
  CGO_LDFLAGS="$(php-config --ldflags) $(php-config --libs)" \
  xcaddy build \
  --output /usr/local/bin/frankenphp \
  --with github.com/dunglas/frankenphp=./ \
  --with github.com/dunglas/frankenphp/caddy=./caddy/ \
  --with github.com/dunglas/caddy-cbrotli \
  # Mercure and Vulcain are included in the official build, but feel free to remove them
  --with github.com/dunglas/mercure/caddy \
  --with github.com/dunglas/vulcain/caddy
# Add extra Caddy modules here

FROM dunglas/frankenphp:latest AS runner

RUN apt-get update \
  && apt-get install -y --no-install-recommends \
  libmagickwand-dev \
  imagemagick \
  && rm -rf /var/lib/apt/lists/*

# add additional extensions here:
RUN install-php-extensions \
  pdo_mysql \
  gd \
  intl \
  imagick \
  zip \
  opcache

# Replace the official binary by the one contained your custom modules
COPY --from=builder /usr/local/bin/frankenphp /usr/local/bin/frankenphp

[Stephan-MC]

After thourough research, i found out i need to install imagemagick in the system for the php imagick extension to work. So i updated the Dockerfile to install imagemagick and libmagickwand as system dependencies before installing the extensions.

FROM dunglas/frankenphp:builder AS builder

# Copy xcaddy in the builder image
COPY --from=caddy:builder /usr/bin/xcaddy /usr/bin/xcaddy

# CGO must be enabled to build FrankenPHP
RUN CGO_ENABLED=1 \
  XCADDY_SETCAP=1 \
  XCADDY_GO_BUILD_FLAGS="-ldflags='-w -s' -tags=nobadger,nomysql,nopgx" \
  CGO_CFLAGS=$(php-config --includes) \
  CGO_LDFLAGS="$(php-config --ldflags) $(php-config --libs)" \
  xcaddy build \
  --output /usr/local/bin/frankenphp \
  --with github.com/dunglas/frankenphp=./ \
  --with github.com/dunglas/frankenphp/caddy=./caddy/ \
  --with github.com/dunglas/caddy-cbrotli \
  # Mercure and Vulcain are included in the official build, but feel free to remove them
  --with github.com/dunglas/mercure/caddy \
  --with github.com/dunglas/vulcain/caddy
# Add extra Caddy modules here

FROM dunglas/frankenphp:latest AS runner

RUN apt-get update \
  && apt-get install -y --no-install-recommends \
  libmagickwand-dev \
  imagemagick \
  && rm -rf /var/lib/apt/lists/*

# add additional extensions here:
RUN install-php-extensions \
  pdo_mysql \
  gd \
  intl \
  imagick \
  zip \
  opcache

# Replace the official binary by the one contained your custom modules
COPY --from=builder /usr/local/bin/frankenphp /usr/local/bin/frankenphp

This solution wasn't working but everything started functioning smoothly after I rebooted my PC.

Seriously, don't even understand what really made it work at this level.