```Removed: -### ChecksRemoved: -Removed: -- ☑ I searched existing issues.Removed: -- ☑ I wrote this report in my own words, except for direct translation if needed.Removed: -
Show
Setting `FLUXER_TRUST_CLIENT_IP_HEADER` to anything but `true` causes .well-known to 500
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
Go to docker-compose.yml
Set FLUXER_TRUST_CLIENT_IP_HEADER to false
Run docker compose up -d --force-recreate api
Run docker compose logs -f
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"}
Original by Tarek
Show
Setting `FLUXER_TRUST_CLIENT_IP_HEADER` to anything but `true` causes .well-known to 500
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
Go to docker-compose.yml
Set FLUXER_TRUST_CLIENT_IP_HEADER to false
Run docker compose up -d --force-recreate api
Run docker compose logs -f
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"}
Checks
☑ I searched existing issues.
☑ I wrote this report in my own words, except for direct translation if needed.