Shelfmark

Shelfmark (image ghcr.io/calibrain/shelfmark) automates discovery and downloading of ebooks for Calibre Web Automated. Downloads are pushed into the shared calibre-library PVC so the main Calibre instance can ingest them automatically.

Notes

  • Uses the same CephFS-backed library PVC as Calibre Web Automated (mounted at /cwa-book-ingest).
  • Uses the built-in Cloudflare bypasser (USE_CF_BYPASS); upstream recommends it over FlareSolverr and wants ~2GB of memory for it.
  • Relies on the calibre-web-automated deployment and the shared calibre-library PVC being present before it reconciles.
  • Env vars in the HelmRelease override and lock the matching UI fields.

OIDC Integration

Shelfmark OIDC is configured in the app UI.

  1. Create an OIDC client in your IdP with callback URL: https://shelfmark.${SECRET_DOMAIN}/api/auth/oidc/callback
  2. Open Shelfmark: Settings -> Security -> Authentication Method -> OIDC
  3. Set:
    • Discovery URL: https://auth.${SECRET_DOMAIN}/.well-known/openid-configuration
    • Client ID: your OIDC client id
    • Client Secret: your OIDC client secret
    • Scopes: openid email profile
  4. Keep a local admin account available for recovery/fallback login.

Source: kubernetes/apps/default/shelfmark/README.md