Restart a Docker app
Most homelab services (Jellyfin, Immich, Sonarr, Vaultwarden, etc.) run as Docker apps on TrueNAS. When a site works on LAN but acts broken, or an app hung after an update, restarting the container is the first safe fix.
Generic steps — applies to any TrueNAS app unless the app doc says otherwise.
Before you restart
- Note which app is broken (e.g. Jellyfin = stream.saxobroko.com).
- Check the pool is ONLINE — Check disk space / dashboard.
- If the whole NAS is unreachable, fix power and network first — Turn everything on.
Restarting an app does not delete media or configs stored on pool volumes. It only stops and starts the container process.
Restart from TrueNAS UI
- Open dsm.saxobroko.com or
https://192.168.2.203on LAN. - Log in with TrueNAS admin (Vaultwarden).
- Go to Apps → Installed Applications (or Docker → Containers on some versions).
- Find the app — e.g. Jellyfin, immich, sonarr, vaultwarden, cloudflared.
- Open the app ⋮ menu or detail page.
- Click Stop — wait until status shows stopped.
- Click Start (or Restart if the UI offers one step).
- Wait 30–60 seconds for the app to bind ports and start health checks.
- Test the public URL or LAN port in a browser.
If Stop/Start is greyed out
- Check Alerts / Jobs for a stuck update or image pull.
- Reboot the app from the same menu if Restart is available.
- As a last resort on LAN only: TrueNAS System → Restart the whole NAS — warn household first (all streams and downloads pause).
Rebooting TrueNAS affects everything
Full NAS reboot stops Jellyfin, photos, torrents, and tunnels until boot completes (several minutes). Prefer restarting a single app first.
Confirm the app is healthy
| Check | How |
|---|---|
| App status in TrueNAS | Running / green |
| Public site | Open the service URL — e.g. stream.saxobroko.com |
| Tunnel | If public URL fails but LAN works, see Cloudflare when a site is down |
| Logs | App detail page → Logs — look for crash loops or "permission denied" on volumes |
Common apps and URLs
| App | Public URL | Notes |
|---|---|---|
| Jellyfin | stream.saxobroko.com | Add Jellyfin user |
| Photos (Immich) | photos.saxobroko.com | Large library = slow start |
| Homepage | dash.saxobroko.com | May need Authentik |
| Vaultwarden | vault.saxobroko.com | Brief sync interruption on restart |
| cloudflared | (no public UI) | If all tunnel sites down, restart cloudflared |
Full list: Services on TrueNAS.
When restart is not enough
| Symptom | Next step |
|---|---|
| App crash-loops in logs | Common issues; disk full or bad config |
| Pool DEGRADED | When the pool is degraded — not an app issue |
| Public down, LAN up | Cloudflare tunnel or DNS — Cloudflare when a site is down |
What not to do
Do not uninstall the app to fix a hang
Uninstall may offer to delete persistent volumes — that wipes app data and configs. Use Stop/Start only unless you are deliberately rebuilding the app and understand volume retention options.