Listen on the socket systemd hands over, so a restart never answers 502 (#214)

OP OpenVibers committed 13 days ago · 8dc787fbeb · 1 file, +4 −1

When the service is socket-activated (LISTEN_FDS=1 for this process), it listens on fd 3, the listener a
systemd .socket unit holds across restarts: requests that arrive during a deploy wait in the kernel's accept
queue and are served by the new process. Without the socket unit it listens on its port as before. The same
three lines Network, Media, Chat and Live use. 2026-10-31: a Codes deploy gave the owner a Cloudflare 502.

Changes

ddiff --git a/server/index.js b/server/index.js
iindex 2aed3be..7f90da8 100644
---- a/server/index.js
++++ b/server/index.js
@@@ -9,7 +9,10 @@ async function main() {
  const { app, ctx } = await createApp();
  const { config } = ctx;
  
--const server = app.listen(config.port, config.host, () => {
++// Socket activation (2026-10-31): systemd's .socket unit holds the listener across restarts, so a deploy
++// queues requests in the kernel instead of answering 502. Without the socket unit, the usual listen.
++const socketActivated = process.env.LISTEN_FDS === '1' && Number(process.env.LISTEN_PID) === process.pid;
++const server = app.listen(...(socketActivated ? [{ fd: 3 }] : [config.port, config.host]), () => {
      console.log(`[Host] ${config.nodeEnv} on http://${config.host}:${config.port} → catalog ${config.baseUrl} (db ${config.db.url ? 'PostgreSQL' : 'embedded PGlite'})`);
      console.log(`[Host] events relay ${ctx.outbox.enabled ? `on → ${config.events.url}` : 'off (events wait in event_outbox)'}; worker ${config.worker.enabled ? 'on' : 'off'}`);
  });