On this page
Navidrome: Problems
Find what is wrong with Navidrome from what its tab says or what happens, then follow the numbered answer.
The chart in words
Start: Navidrome is not working as it should
- Then: What does its tab say?
- Failed or Not answering: 1. Start it again
- Not supported: 2. Update it or update Starboard
- Active: What is wrong?
- Its page will not open: 3. Open its web page
- Music is missing: 4. Put the music in the music folder
- A Subsonic app cannot connect: 5. Connect a Subsonic app
1 Start it again
- On Navidrome'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 Navidrome 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 web page
- Go to Settings, then Plug-ins, then Navidrome.
- Check its state is Active. If not, select Activate.
- In Its web page, select Open Navidrome. Use the address shown there: Starboard chooses the port, 4533 when it is free, so it may be a different one.
- Open it from a device on your home network. The page is not on the internet.
4 Put the music in the music folder
Navidrome reads only music in your media folder, as /media/music. Music anywhere else is not shown.
- Put your music in
musicin your media folder. - Open Navidrome to check the music is there. When it checks for new music is set in Navidrome itself: read Navidrome's own help.
It reads the folder only, so it cannot fix a file's name or tags for you.
5 Connect a Subsonic app
- In the app, use the address in Its web page, such as
http://192.168.1.20:4533, withhttp://and the port. - Sign in with an account you made in Navidrome, not your Starboard account.
- Use the app on your home network. Remote access shares only Starboard, Jellyfin and Audiobookshelf, so Navidrome does not answer away from home through it.
Report a problem
If none of these helps, tell its maker, with what its tab says: the plug-ins' issues on GitHub. For a problem inside Navidrome itself, read Navidrome's own help.
Find out more
This page on GitHub, where the help is written.