29 lines
1.2 KiB
Markdown
29 lines
1.2 KiB
Markdown
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.
|