Calibre-Web

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

PublishedHow to add it
On this page

Calibre-Web: Install

Add Calibre-Web from Starboard's Catalogue, where it is listed under Apps you can add. Starboard shows what it may do and tests it before anything is added. At the end, Calibre-Web is active, with its own page on your home network, and set up.

Before you begin

  • Starboard with plug-in API 1.14 or later. An older Starboard is offered an earlier version: read Updates.
  • Your Starboard password. Adding and removing a plug-in ask for it.
  • A Calibre library in the books folder of your media folder: a folder with metadata.db in it. Calibre-Web reads it and never changes it.

What it may do

Starboard lists these before you add it, each with its risk.

Permission Risk
Reach other computers on your home network, and the internet (network:lan) Medium
Open its own web page on your home network, at a port Starboard chooses (network:port) Medium

What it runs:

  • app: reaches your home network and the internet, and this computer as host.docker.internal. It can use its own folder in Starboard's data (data/plugins/calibre-web), the books folder in your media folder, to read only. Its web page is on your home network at port 8083 when that port is free, or the next free one.

Like every plug-in, it runs read only, as a user that is not root, with no extra rights. Its image is pinned by digest, so what you approved is what runs.

Memory and processor

  • app: 384 MB of memory and 0.5 of a processor core at most, and 128 processes.

Measured:

  • 182.2 MiB at rest as Starboard runs it, with an empty library (13 November 2026).

Add it

  1. Go to Settings, then Plug-ins, then Catalogue.
  2. Under Apps you can add, find Calibre-Web and select Install….
  3. A slide-out opens with what it can read, change and reach. Read it all.
  4. Enter your Starboard password and select Install Calibre-Web. To stop, select Cancel: nothing is installed.
  5. Calibre-Web's own tab opens under Settings, then Plug-ins. Select Activate. Its state changes to Active.

Add it by its address

On the Catalogue page, under Add one from elsewhere, paste this into The plug-in's manifest address, then select What it does and carry on from step 3:

https://raw.githubusercontent.com/TheMightyTRex/starboard-plugins/main/calibre-web/starboard-plugin.json

Or run its installer, install.py in its folder, on any computer with Python, and give your Starboard's address.

Set it up

Calibre-Web's tab shows its address on your home network, under Its web page.

  1. On Calibre-Web's tab, under Its web page, select Open Calibre-Web. Its page opens in a new tab.
  2. Sign in with Calibre-Web's own first sign-in: admin, with the password admin123.
  3. In Calibre-Web, go to Admin, then Edit user, and change the password straight away. Anyone on your home network can open the page.
  4. For Location of Calibre database, enter /media/books, the folder with metadata.db, and save.

The books folder is read only, so uploading and editing books in Calibre-Web are not possible. Add and edit books with Calibre itself.

Remove it

  1. Go to Settings, then Plug-ins, then Calibre-Web.
  2. Under Remove, select Remove Calibre-Web.
  3. Choose where its folder goes: Keep it with Starboard's data (in data/plugins/.removed) or Move it to the holding folder, listed in System, Clean up, where you can put it back or delete it for good.
  4. Enter your Starboard password and select Remove.

Its containers stop and go, and its API key stops working. Nothing is deleted.

To stop it for a while instead, select Deactivate on its tab: its settings and folder are kept.

Find out more

This page on GitHub, where the help is written.