
Deploy Calibre-Web Automated
Self-hosted ebook library with auto import, conversion and metadata
Calibre-Web Automated
Just deployed
/config
Deploy and Host Calibre-Web Automated on Railway
Calibre-Web Automated (CWA) is an open-source, self-hosted ebook library. It combines the Calibre-Web reading and management interface with the Calibre conversion tools. Books you upload or drop into its ingest folder are converted to your preferred format, enriched with metadata and covers, and added to your library, readable in any browser or e-reader.
About Hosting Calibre-Web Automated
CWA runs as one container that bundles Calibre-Web, Calibre 9.1 and background services for ingest, conversion and metadata. It keeps its settings, the Calibre library and an ingest folder on disk. This template puts all three on a single Railway volume at /config, so books and settings survive redeploys and restarts. On first boot it creates an empty library and sets the admin password from a generated variable, so the app is never public with the default admin123. Railway builds the service from a public GitHub repo that pins the official image by version and digest, gives it a public HTTPS domain and checks /health.
Common Use Cases
- A personal or family ebook library you can browse, read and download from any device
- Automatic import and conversion of EPUB, MOBI, AZW3, PDF, CBZ and other formats, with metadata and cover fetching
- Syncing books and reading progress with Kobo and KOReader devices, OPDS readers or send-to-Kindle
Dependencies for Calibre-Web Automated Hosting
- One service built from
aalfath/calibre-web-automated-railway-template(officialcrocodilestick/calibre-web-automatedv4.0.8 image) - One Railway volume at
/configfor settings, the library and the ingest folder
Deployment Dependencies
- Calibre-Web Automated: https://github.com/crocodilestick/Calibre-Web-Automated
- Release v4.0.8: https://github.com/crocodilestick/Calibre-Web-Automated/releases/tag/v4.0.8
- Template repo: https://github.com/aalfath/calibre-web-automated-railway-template
Implementation Details
The template has one service, Calibre-Web Automated (public, port 8083, health check /health), and nothing to fill in at deploy time.
After deploy:
- Open the public URL and sign in as
adminwith the password from the service's Variables tab (ADMIN_PASSWORD). - Under Admin, set the admin's email and change the password if you like. Restarts never overwrite it.
- Add books with Upload. CWA settings (target format, metadata providers, auto-delete) are under Admin, CWA Settings.
Variables: ADMIN_PASSWORD (generated, first admin password) and PORT (8083, leave as it is). Optional ones you can add later: TZ, HARDCOVER_TOKEN for Hardcover metadata. Mail, OAuth/OIDC and LDAP are set in the app.
Memory: about 160 MB idle and up to about 450 MB while converting a book, so it fits a 0.5 GB service. Give it 1 GB or more for large PDF or comic conversions.
Updates: the repo pins the image by tag and digest. When we release a new CWA version, Railway shows an "update available" notice on your project, and you choose when to apply it. Check the repo's CHANGELOG.md first. Your volume is kept.
Why Deploy Calibre-Web Automated on Railway?
Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.
By deploying Calibre-Web Automated on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.
Template Content
Calibre-Web Automated
aalfath/calibre-web-automated-railway-template