---
title: "Deploy Calibre-Web Automated"
description: "Self-hosted ebook library with auto import, conversion and metadata"
category: "Storage"
url: https://railway.com/deploy/calibre-web-automa-1
---

# Deploy Calibre-Web Automated

Self-hosted ebook library with auto import, conversion and metadata

**[Deploy Calibre-Web Automated on Railway](https://railway.com/template/calibre-web-automa-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/calibre-web-automa-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Storage

## Template content

### Calibre-Web Automated https://raw.githubusercontent.com/crocodilestick/Calibre-Web-Automated/v4.0.8/README_images/cwa-logo-round-light.png

- **Source:** https://github.com/aalfath/calibre-web-automated-railway-template
- **Health check:** /health
- **Public domain:** Yes

## Documentation

# 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` (official `crocodilestick/calibre-web-automated` v4.0.8 image)
* One Railway volume at `/config` for 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:

1. Open the public URL and sign in as `admin` with the password from the service's Variables tab (`ADMIN_PASSWORD`).
2. Under Admin, set the admin's email and change the password if you like. Restarts never overwrite it.
3. 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.



## Similar templates

- [RustFS | (Just Updated) S3 Object Store, Public URL and Keys Set](https://railway.com/deploy/rustfs-or-just-updated-s3-object-store-p) — S3-compatible object store, keys and public URL preset, volume kept
- [TimescaleDB](https://railway.com/deploy/timescaledb-railway-template) — A PostgreSQL-based time-series database for analytics on Railway.
- [Neo4j 2026.10 Community](https://railway.com/deploy/neo4j-202610-community) — Neo4j graph database with APOC, Browser, Bolt TCP proxy and a volume

Open this page in a browser: https://railway.com/deploy/calibre-web-automa-1
