Setting `FLUXER_TRUST_CLIENT_IP_HEADER` to anything but `true` causes .well-known to 500

(#698) Bug Needs triage self-hosting

Summary

Setting FLUXER_TRUST_CLIENT_IP_HEADER to anything but true, i.e false or a string causes calls to .well-known to 500 due to MissingClientHeader

Steps to reproduce

  1. Go to docker-compose.yml
  2. Set FLUXER_TRUST_CLIENT_IP_HEADER to false
  3. Run docker compose up -d --force-recreate api
  4. Run docker compose logs -f
  5. Observe the errors you get when accessing frontend

Environment

Whatever version was latest 1st July 2026

Logs or screenshots

api-1               | {"level":"error","time":"2026-07-02T14:48:06.764Z","service":"errors","env":"production","err":{"type":"MissingClientIpError","message":"Client IP header is required","stack":"MissingClientIpError: Client IP header is required\n    at requireClientIp (/usr/src/app/fluxer_api/node_modules/.pnpm/@fluxer+ip_utils@file+packages+ip_utils/node_modules/@fluxer/ip_utils/src/ClientIp.ts:132:9)\n    at Object.handler (/usr/src/app/fluxer_api/src/api/middleware/UserMiddleware.ts:90:3)\n    at file:///usr/src/app/fluxer_api/node_modules/.pnpm/hono@4.12.2/node_modules/hono/dist/hono-base.js:118:86\n    at dispatch (file:///usr/src/app/fluxer_api/node_modules/.pnpm/hono@4.12.2/node_modules/hono/dist/compose.js:22:23)\n    at file:///usr/src/app/fluxer_api/node_modules/.pnpm/hono@4.12.2/node_modules/hono/dist/compose.js:5:12\n    at handler (file:///usr/src/app/fluxer_api/node_modules/.pnpm/hono@4.12.2/node_modules/hono/dist/hono-base.js:118:74)\n    at dispatch (file:///usr/src/app/fluxer_api/node_modules/.pnpm/hono@4.12.2/node_modules/hono/dist/compose.js:22:23)\n    at file:///usr/src/app/fluxer_api/node_modules/.pnpm/hono@4.12.2/node_modules/hono/dist/compose.js:22:46\n    at Object.handler (/usr/src/app/fluxer_api/src/api/middleware/ServiceMiddleware.ts:788:8)\n    at process.processTicksAndRejections (node:internal/process/task_queues:104:5)","name":"MissingClientIpError"},"msg":"Unhandled error occurred"}                                                                      
api-1               | {"level":"info","time":"2026-07-02T14:48:06.764Z","service":"fluxer-api","env":"production","method":"GET","path":"/.well-known/fluxer","status":500,"durationMs":1,"msg":"Request completed"}  

0 comments

Sign in with Fluxer to comment and vote.
Deleted comment
Removed by moderator Rex: Removed a general status note that was posted on many GitHub threads. It no longer applies here.