Kavita

Version 1.1.1 · plug-in API >=1.14 <2.0

PublishedHow to add it
On this page

Kavita: Problems

Find what is wrong with Kavita from what its tab says or what happens, then follow the numbered answer.

Find your answer
Flow chart: Kavita is not working as it should. The same chart is written out in words after it.Failed or Not answeringNot supportedActiveIts page will not openBooks or comics aremissingAn e-reader app cannotconnectThere are two KavitasKavita is not workingas it shouldWhat does its tabsay?What is wrong?Start it again1Update it or updateStarboard2Open its web page3Add the libraries4Connect a reading app5Keep one Kavita6
The chart in words

Start: Kavita is not working as it should

1 Start it again

  1. On Kavita's tab, read the message under its state: it says why it stopped.
  2. Select Try again.
  3. If it stopped soon after an update, select Roll back to and the version you had. Read Updates.
  4. 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.

  1. Select Check for an update on its tab.
  2. If there is none, update Starboard. Read Update Starboard.

3 Open its web page

  1. Go to Settings, then Plug-ins, then Kavita.
  2. Check its state is Active. If not, select Activate.
  3. 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.
  4. 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.

  1. Open Kavita and sign in with its admin account.
  2. Add a library for /media/books.
  3. Add a library for /media/comics.
  4. 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

  1. In an app that speaks OPDS, use the address in Its web page, with http:// and the port.
  2. Sign in with an account you made in Kavita, not your Starboard account.
  3. 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.

  1. Choose the one you want to keep.
  2. 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.