Wizarr is the invitation and permalink helper for Jellyfin that can generate share links and proxy access for family guests.
This page documents the wizarr service and its config directory.
- Container:
wizarr
- Image:
ghcr.io/wizarrrr/wizarr:latest
- Stack: Smithflix Stack
- Docker network:
smithflix_default
- Restart policy:
unless-stopped
- Health state: healthy on
2026-04-07
- Public hostname:
wizarr.better-than.tv
¶ Config and Data Paths
- Config root:
/srv/docker/wizarr/database
- Wizarr stores SQLite state and invite data in that directory
- LAN URL:
http://192.168.0.113:5690
- Public URL:
https://wizarr.better-than.tv
- Host port mapping:
5690 -> 5690
¶ Authentication and Secret Locations
- Wizarr secrets live inside the SQLite database under
/srv/docker/wizarr/database
- It uses Jellyfin API credentials that are managed through the container UI, not the compose file
- If Jellyfin plugins mention
https://wizarr.better-than.tv links, validate the URL after any proxy change
- The shared invite manager must stay running whenever Jellyfin is offering ephemeral links
¶ Monitoring and Logs
- Docker logging driver is
json-file
- The container health check was reported as healthy on
2026-04-07
- Inspect
docker logs wizarr when invites fail or the UI refuses to load
¶ Backup and Restore
- The config directory is under
/srv/docker/wizarr, which is included in Duplicati coverage
- Restore the entire directory to preserve invite history and API tokens
¶ Failure Modes and Recovery
- If the Wizarr UI loses Jellyfin credentials, existing links stop working while the container still looks healthy
- Proxy or TLS misconfigurations on
wizarr.better-than.tv will manifest as login failures even though the LAN port is alive