On this page
Kavita: Problems
Find what is wrong with Kavita from what its tab says or what happens, then follow the numbered answer.
The chart in words
Start: Kavita 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
- Books or comics are missing: 4. Add the libraries
- An e-reader app cannot connect: 5. Connect a reading app
- There are two Kavitas: 6. Keep one Kavita
1 Start it again
- On Kavita'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 Kavita 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 Kavita.
- Check its state is Active. If not, select Activate.
- In Its web page, select Open Kavita. Use the address shown there: Starboard chooses the port, 5000 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 Add the libraries
Kavita can read only books and comics in your media folder, as /media/books and /media/comics, and shows nothing until you add a library.
- Open Kavita and sign in with its admin account.
- Add a library for
/media/books. - Add a library for
/media/comics. - Put your files in those two folders. Files anywhere else are not shown.
It reads the folders only, so it cannot change, move or delete a file.
5 Connect a reading app
- In an app that speaks OPDS, use the address in Its web page, with
http://and the port. - Sign in with an account you made in Kavita, not your Starboard account.
- Use the app on your home network. Remote access shares only Starboard, Jellyfin and Audiobookshelf, so Kavita does not answer away from home through it.
6 Keep one Kavita
The main install can also add Kavita, in Install apps, Ebooks. With both, the plug-in takes another port when 5000 is in use, and each has its own accounts and libraries.
- Choose the one you want to keep.
- Remove the other. For the plug-in, read Install.
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 Kavita itself, read Kavita's own help.
Find out more
This page on GitHub, where the help is written.