Install Numi as an App¶
You can install Numi Chat as a Progressive Web App (PWA) on your phone, tablet, or computer. It opens in its own standalone window with a dedicated dock or home-screen icon, hides the browser address bar, and keeps previously opened chats readable offline.
Browsers offer app installation when Numi is served over HTTPS, or over
http://localhost on the same machine. Plain HTTP over a LAN IP does not
support PWA installation.
Install on your device¶
| Platform | How to install |
|---|---|
| Android (Chrome, Edge, Samsung Internet) | Open Numi, open the browser menu, and tap Install app or Add to Home screen. |
| iPhone and iPad (Safari, or iOS 16.4+ browsers) | Tap Share, then Add to Home Screen. |
| Windows, macOS, Linux (Chrome, Edge, Brave, Vivaldi) | Click the install icon on the right side of the address bar, or choose Install Numi Chat from the browser menu. |
| macOS (Safari 17+) | Choose File -> Add to Dock. |
Desktop Firefox does not support installing web apps; use Numi in a regular browser tab there.
On iPhone and iPad, the installed home-screen app uses isolated storage separate from Safari, so you will need to sign in once after installing.
Offline reading¶
As you browse, the installed app caches the UI shell, your sidebar chat list, and any conversations you have opened on that device:
- Without a network connection: The app still launches and displays the last loaded state of your chat list and previously opened conversations.
- Read-only while offline: An Offline notice appears above the message box. You can't send messages or open an uncached conversation until you reconnect.
- Automatic sync: As soon as your connection returns, Numi reconnects and refreshes the current chat state.
Offline caches are cleared automatically when you sign out, when your session expires, or when you delete a chat. One-off downloads (such as full data exports) and admin pages are never cached offline.
Updates¶
Installed web apps update automatically whenever the server is updated. On
launch or reload, Numi checks the server build version (state/build.json); if
a newer deploy is available, the About menu in your profile offers a
one-click Reload.