Fix: build dashboard on build platform to avoid QEMU illegal instruction crashes

Author: f3l1x

dashboard/Dockerfile

@@ -17,7 +17,13 @@ RUN apk add --no-cache curl tar && \
     rm -rf /tmp/mem0.tar.gz /tmp/mem0-${MEM0_VERSION} /app/node_modules /app/.next
 
 # BUILD ########################################################################
-FROM base AS builder
+# Runs on the build platform (no QEMU emulation, which intermittently crashes
+# node/pnpm with "Illegal instruction" on arm64). The Next.js standalone output
+# is plain JS, except for the native sharp binaries, so install the optional
+# dependencies of every target architecture and let sharp pick one at runtime.
+FROM --platform=$BUILDPLATFORM node:20-alpine AS builder
+RUN apk add --no-cache libc6-compat
+WORKDIR /app
 
 COPY --from=source /app /app
 
@@ -26,7 +32,8 @@ ENV NEXT_TELEMETRY_DISABLED=1
 ENV NEXT_PUBLIC_API_URL=NEXT_PUBLIC_API_URL
 ENV NEXT_PUBLIC_INSTANCE_NAME=NEXT_PUBLIC_INSTANCE_NAME
 
-RUN corepack enable pnpm && \
+RUN printf '\nsupportedArchitectures:\n  os: [linux]\n  libc: [musl]\n  cpu: [x64, arm64]\n' >> pnpm-workspace.yaml && \
+    corepack enable pnpm && \
     pnpm install && \
     pnpm build
 
@@ -45,6 +52,21 @@ RUN addgroup --system --gid 1001 nodejs && \
 COPY --from=builder /app/public ./public
 COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
 COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
+# The standalone trace only contains the sharp binaries of the build platform,
+# so add the ones matching the target platform from the builder's pnpm store.
+ARG TARGETARCH
+RUN --mount=from=builder,source=/app/node_modules/.pnpm,target=/mnt/pnpm \
+    arch=$([ "${TARGETARCH}" = "amd64" ] && echo x64 || echo arm64) && \
+    cd /app/node_modules/.pnpm && \
+    for pkg in /mnt/pnpm/@img+sharp-linuxmusl-${arch}@* /mnt/pnpm/@img+sharp-libvips-linuxmusl-${arch}@*; do \
+        [ -e "$(basename "${pkg}")" ] || cp -a "${pkg}" . ; \
+    done && \
+    for dir in sharp@*/node_modules/@img; do \
+        for pkg in @img+sharp-linuxmusl-${arch}@*; do \
+            ln -sfn "../../../${pkg}/node_modules/@img/sharp-linuxmusl-${arch}" "${dir}/sharp-linuxmusl-${arch}"; \
+        done; \
+    done && \
+    chown -R nextjs:nodejs /app/node_modules
 COPY --from=builder --chown=nextjs:nodejs /app/entrypoint.sh /home/nextjs/entrypoint.sh
 RUN chmod 755 /home/nextjs/entrypoint.sh