On this page
Wizarr: Problems
Find what is wrong with Wizarr, then follow the numbered answer.
The chart in words
Start: Wizarr is not working as it should
- Then: What does its tab say?
- Did not start: 1. Start it again
- Not supported: 2. Update it or update Starboard
- Active, but something is wrong: What is wrong?
- Its page does not open: 3. Open its page
- It cannot reach Jellyfin: 4. Connect it to Jellyfin
- A link does not work away from home: 5. Make links work away from home
1 Start it again
Its tab says Did not start when Wizarr did not start, or stopped answering.
- On Wizarr's tab, read the message under its state: it says why it stopped.
- Select Try again.
- If it stopped soon after an update, select Roll back to and the version you had. Read Updates.
- Still failing: go to System, then Logs, and find its name.
2 Update it or update Starboard
Your Starboard's plug-in API is outside what this version of Wizarr works with, so Starboard stopped it.
- Select Check for an update on its tab.
- If there is none, update Starboard. Read Update Starboard.
3 Open its page
Wizarr's page is on your home network, at this computer's address and the port Starboard chose for it. The port is not always the usual one: Starboard takes the next free port when that one is in use.
- Check Wizarr's tab says Active. Starboard gives it a port only once it is active.
- Under Its web page, read the address, then select Open Wizarr.
- Open it from a device on your home network. It does not open from away from home.
- If it still does not open, deactivate it, activate it again and wait a minute for the app to start.
4 Connect it to Jellyfin
Wizarr has no Jellyfin key from Starboard: it uses one you make.
- In Jellyfin, go to Dashboard, then API keys, and make a key for Wizarr.
- In Wizarr, give Jellyfin's address as
http://host.docker.internal:8096, with that key. - Check Jellyfin is running: in Starboard, go to Apps and check Jellyfin's card.
5 Make links work away from home
An invitation link uses Wizarr's address on your home network, so it opens only there.
- Add the Remote access plug-in, or use your own address for Wizarr.
- In Wizarr, check that new invitation links use that address.
Report a problem
If none of these helps, tell its maker, with what its tab says: the plug-ins' issues on GitHub.
Find out more
This page on GitHub, where the help is written.