Skip to main content
Upstream source: Current installation guide. Calibre-Web needs an existing Calibre library (metadata.db) in /books. The /config volume holds Calibre-Web’s own users and settings; a separate Towbar Datastore is not used.

Towbar manifest

.towbar/services/calibre-web.service.yml

Configure

  1. Prepare the example server, connect the repository, and map production to the branch containing these manifests. Replace the example server IP and domain. Commit the manifests, then sync the repository and inspect the resolved configuration.
  2. Keep the Service’s named volumes attached across deployments. Towbar’s Datastore backup policy does not back up Service volumes, so include them in your own recovery plan.
  3. Deploy the Service, then perform the checks below before enabling auto-deploy.
  4. After deployment, transfer an existing Calibre library to the server and use docker cp to place the whole library, including metadata.db, under /books in the running container.

Verify

Import a real Calibre library into /books, point the first-run form at /books/metadata.db, and open a book. An empty volume cannot be used as a library. For field constraints, see Service manifest.
Last modified on September 27, 2026