Calibre-Web

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

PublishedHow to add it
On this page

Calibre-Web: Problems

Find what is wrong with Calibre-Web, then follow the numbered answer.

Find your answer
Flow chart: Calibre-Web is not working as it should. The same chart is written out in words after it.Did not startNot supportedActive, but something iswrongIts page does not openIt finds no booksIt will not upload or editbooksCalibre-Web is notworking as it shouldWhat does its tab say?What is wrong?Start it again1Update it or updateStarboard2Open its page3Point it at your library4Add books with Calibre5
The chart in words

Start: Calibre-Web is not working as it should

1 Start it again

Its tab says Did not start when Calibre-Web did not start, or stopped answering.

  1. On Calibre-Web'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 Calibre-Web 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 page

Calibre-Web'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.

  1. Check Calibre-Web's tab says Active. Starboard gives it a port only once it is active.
  2. Under Its web page, read the address, then select Open Calibre-Web.
  3. Open it from a device on your home network. It does not open from away from home.
  4. If it still does not open, deactivate it, activate it again and wait a minute for the app to start.

4 Point it at your library

Calibre-Web finds books only in the books folder of your media folder, where a Calibre library keeps metadata.db.

  1. Check that the books folder in your media folder has metadata.db in it. If your library is somewhere else, move it there with Calibre.
  2. In Calibre-Web's admin settings, find Location of Calibre database.
  3. Enter /media/books and save.

5 Add books with Calibre

Starboard gives Calibre-Web the books folder read only, so it can never change your library. Uploading, editing details and deleting books in Calibre-Web do not work, by design.

  1. Add or change books with Calibre itself, in the same library.
  2. Calibre-Web shows the changes when it next reads the library.

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.