marco/buildmymcpserver
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(docker): healthcheck must hit 127.0.0.1, not localhost

Browse Source 
The servers bind IPv4 (0.0.0.0) only. busybox wget resolves `localhost`
to ::1 first and does not fall back to IPv4, so the healthcheck failed
with "connection refused" and the container showed as unhealthy while
serving fine. Verified on the production api container.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Marco Sadjadi 2026-05-21 18:07:01 +02:00
parent c7e6537c64
commit a288179954
2 changed files with 6 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
apps/api/Dockerfile
View File

@ -28,6 +28,8 @@ ENV NODE_ENV=production
COPY . . COPY . .
WORKDIR /app/apps/api WORKDIR /app/apps/api
EXPOSE 4000 EXPOSE 4000
# Use 127.0.0.1, not localhost: the server binds IPv4 only, and busybox wget
# resolves localhost to ::1 first — which would refuse and fail the check.
HEALTHCHECK --interval=20s --timeout=4s --start-period=20s --retries=3 \ HEALTHCHECK --interval=20s --timeout=4s --start-period=20s --retries=3 \
CMD wget -qO- http://localhost:4000/health || exit 1 CMD wget -qO- http://127.0.0.1:4000/health || exit 1
CMD ["pnpm", "start"] CMD ["pnpm", "start"]

4
apps/runner-template/Dockerfile
View File

@ -10,6 +10,8 @@ COPY --from=deps /app/node_modules ./node_modules
COPY package.json tsconfig.json ./ COPY package.json tsconfig.json ./
COPY src ./src COPY src ./src
EXPOSE 3000 EXPOSE 3000
# 127.0.0.1, not localhost: busybox wget resolves localhost to ::1 first and
# the server binds IPv4 only, so a localhost check would wrongly fail.
HEALTHCHECK --interval=15s --timeout=3s --start-period=10s --retries=3 \ HEALTHCHECK --interval=15s --timeout=3s --start-period=10s --retries=3 \
CMD wget -qO- http://localhost:3000/health || exit 1 CMD wget -qO- http://127.0.0.1:3000/health || exit 1
CMD ["npx", "tsx", "src/server.ts"] CMD ["npx", "tsx", "src/server.ts"]