Troubleshooting

"Connexion fermée" / the socket closes immediately

The IRC server is rejecting the Origin. Add the host Orbit is served from to the server's WebSocket origin allow-list (e.g. InspIRCd <wsorigin allow="https://chat.example.org">).

I don't see the latest version after a deploy

A service worker is serving the cached build. Bump the cache version in public/sw.js on every deploy (const CACHE = 'app-vN') — the worker then auto-reloads installed clients. Or hard-refresh.

Notifications don't work

• The browser must grant permission (Settings → Notifications).
• Web Push when the tab is closed needs the server's draft/webpush support (VAPID) and you to be logged into an account (subscriptions are stored per account).

The keyboard covers the input on mobile

Orbit tracks the visual viewport to keep the composer above the keyboard. This works best on Chromium-based browsers; some other mobile browsers report the viewport late.

Channels start empty

Server-side history needs draft/chathistory + a storage backend on the server, and the channel must have history enabled (e.g. InspIRCd +H). Without it, channels begin empty.