pez-infra/ansible/services/bookshelf/README.md
Rasmus "Pez" Wejlgaard 644b608831
Some checks are pending
Deploy (on merge) / Discover hosts (push) Waiting to run
Deploy (on merge) / deploy (push) Blocked by required conditions
chore: retire readarr service, replaced by bookshelf (#123)
Bookshelf (PR #122) is a Readarr revival and now owns port 8787 on
london-b, so the old custom Readarr systemd unit is removed:

- drop readarr from the media_stack role's unit-deploy and enable loops,
  and add an idempotent decommission task (stop, disable, remove unit)
  so the host tears it down via Ansible rather than ad-hoc SSH
- delete services/readarr/readarr.service
- update docs (services, london-b host, service inventory) to describe
  bookshelf as a Docker service instead of a custom systemd unit

The public readarr.pez.sh hostname is kept and now reverse-proxies to
bookshelf on :8787 — DNS, Caddy and Authelia (pez_readarr_users group)
are unchanged.
2026-06-06 15:50:37 +01:00

15 lines
732 B
Markdown

# Bookshelf
Ebook/audiobook collection manager — a revival of Readarr. Monitors RSS
feeds, downloads, sorts and renames books via Usenet/BitTorrent.
- **Host:** london-b
- **Port:** 8787
- **Image:** `ghcr.io/pennydreadful/bookshelf:hardcover` (Hardcover metadata; use the `softcover` tag for a Goodreads/Readarr-compatible database)
- **Config:** `/root/bookshelf/` (`:/config`)
- **Book library:** `/hdd/books` (mounted at the same path in the container, on the ZFS pool)
Exposed at **https://readarr.pez.sh** (and `.solutions`) behind Authelia —
the hostname is retained from the retired Readarr service it replaces, with
Caddy reverse-proxying to `london-b:8787`. Authelia gates access via the
`pez_readarr_users` group.