On this page
Calibre-Web: Problems
Find what is wrong with Calibre-Web, then follow the numbered answer.
The chart in words
Start: Calibre-Web 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 finds no books: 4. Point it at your library
- It will not upload or edit books: 5. Add books with Calibre
1 Start it again
Its tab says Did not start when Calibre-Web did not start, or stopped answering.
- On Calibre-Web'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 Calibre-Web 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
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.
- Check Calibre-Web's tab says Active. Starboard gives it a port only once it is active.
- Under Its web page, read the address, then select Open Calibre-Web.
- 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 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.
- Check that the
booksfolder in your media folder hasmetadata.dbin it. If your library is somewhere else, move it there with Calibre. - In Calibre-Web's admin settings, find Location of Calibre database.
- Enter
/media/booksand 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.
- Add or change books with Calibre itself, in the same library.
- 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.