📱 Install as App (PWA)
LibreFolio can be installed as a Progressive Web App (PWA) on your device. This gives you an app-like experience: full-screen mode, no browser address bar, and a home screen icon — without downloading from an app store.
✅ What You Get
| Feature | Description |
|---|---|
| Full-screen mode | No address bar or browser UI clutter |
| Home screen icon | Launch LibreFolio like a native app |
| No gestures interference | Swipe-back and double-tap zoom disabled |
| Persistent session | Stays logged in between launches |
Online Only
LibreFolio PWA requires an active network connection. There is no offline mode — your data lives on your server.
📲 How to Install
Android (Chrome / Edge)
- Open LibreFolio in Chrome or Edge
- Look for the "Install App" button in the Help & Support menu (top-right ❓ icon)
- Tap Install when prompted
- LibreFolio appears on your home screen
Alternative method
If the Install button doesn't appear, tap the browser's ⋮ menu → "Add to Home screen" or "Install app".
iOS (Safari)
- Open LibreFolio in Safari (required — other browsers don't support PWA on iOS)
- Tap the Share button (square with arrow)
- Scroll down and tap "Add to Home Screen"
- Tap Add
iOS Limitation
The automatic install prompt is not available on iOS. Use the Share menu as described above. The Help menu will show instructions if you're on an iOS device.
Desktop (Chrome / Edge)
- Open LibreFolio in Chrome or Edge
- Click the "Install App" button in the Help & Support menu
- Or click the install icon (⊕) in the browser's address bar
- LibreFolio opens in its own window
🌐 HTTP vs HTTPS
| Setup | PWA Install | Auto-prompt |
|---|---|---|
https:// (Tailscale, reverse proxy) |
✅ Full support | ✅ Chrome shows the banner |
http://localhost |
✅ Works | ✅ Works |
http://192.168.x.x (LAN) |
❌ Not available (HTTPS required) | ❌ No auto-prompt |
HTTPS Connection Requirement for PWA
To install LibreFolio as a PWA, modern browsers strictly require a secure HTTPS connection (except when accessing it through localhost or 127.0.0.1 for local development).
If you open LibreFolio over plain HTTP on your local network (for example, http://192.168.1.100:6040), PWA installation will not be available and the app cannot run in standalone mode.
You can choose any method you prefer to enable HTTPS on your instance, but we strongly recommend our simple, free guide: Tailscale Exposure Guide. It gives you a secure HTTPS URL without configuring SSL certificates or opening router ports.
🔧 Troubleshooting
| Problem | Solution |
|---|---|
| Install button not showing | You may already have it installed, or you're on HTTP LAN |
| iOS: no install option | Must use Safari — Chrome/Firefox on iOS don't support PWA |
| App doesn't update | Close and reopen the app — it always fetches the latest version |
| Lost session after update | Re-login — this is expected after server restarts |