Order: 50

# 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.