You have a Calibre library on your desktop computer with hundreds of ebooks organized exactly how you want them. Then you pick up your phone and want to read one of those books. Your options, without any additional setup, are to email the file to yourself, copy it over USB, or go back to your laptop. None of those are good. Calibre-Web solves this without a subscription.
Calibre (available at calibre-ebook.com) is a free, cross-platform desktop application that manages ebook files. It organizes your EPUB, MOBI, PDF, and other ebook files into a library database with metadata: title, author, series, cover image, and description for each book. It is the standard tool for anyone who manages their own ebook collection. Calibre-Web is a completely separate project that reads that same library database and serves it through a browser. You organize books in Calibre on your desktop, and Calibre-Web makes that library accessible from any device on your network, or from anywhere on the internet if you choose.
The project lives at github.com/janeczku/calibre-web with 17,792 stars and a GPL-3.0 license. GPL-3.0 (the GNU General Public License) is an open-source license that means the software is free to use, modify, and distribute, with no subscription or purchase required.
| Fact | Value |
|---|---|
| What it is | Web interface for a self-hosted ebook library |
| Built by | Calibre-Web contributors (open-source) |
| License | GPL-3.0 (free to use) |
| Platforms | Docker, Linux, Raspberry Pi, NAS devices |
| Requires | An existing Calibre library folder; Docker or Python |
| Install method | Docker (recommended) |
| Verdict | Install if you have a Calibre ebook library and want to access it from any device without copying files manually |
What Calibre-Web actually is
Calibre-Web is a web application that sits in front of your existing Calibre library. It does not replace Calibre. It does not modify your library. It reads the metadata.db file that Calibre maintains and presents it through a browser interface.
The key distinction matters because your library management workflow stays exactly the same. You continue adding books, editing metadata, and organizing series in the Calibre desktop app on your computer. Calibre-Web just makes whatever is in that library available over the web. If you add a new book in Calibre, it appears in Calibre-Web automatically because both applications are reading the same database file.
The supported formats cover the full range of ebook files in common use. EPUB is the open standard format used by most ebook stores and readers outside Amazon's ecosystem. MOBI and AZW3 are Amazon Kindle formats. PDF needs no explanation. CBZ and CBR are comic book archive formats. Calibre-Web can also convert between these formats on the fly if you install Calibre's conversion tool on the same server, which is one additional setup step but not required for basic use.
The project is designed for personal or family use rather than public libraries. You install it on a server inside your home network, a Raspberry Pi (a small, inexpensive single-board computer that runs Linux and is commonly used for home server tasks), a NAS device (Network Attached Storage, a small box dedicated to storing files and running services on your home network), or a cloud VPS (a virtual private server, a rented Linux machine from providers like DigitalOcean or Hetzner that you control over the internet). Your books live on that server's disk or on a network share that the server can read.
What you get after installing it
Once Calibre-Web is running, everything happens in the browser.
The library browser is the main screen. Your books appear with cover images, organized by the metadata Calibre has assigned to them. Search works across title, author, series, tag, and publisher. The left sidebar shows filters: by author, by series, by tag, by language, by publisher. If your Calibre library has 500 books organized into series with consistent tags, Calibre-Web exposes all of that structure in the browser.
The built-in EPUB reader lets you read books directly in the browser without downloading the file first. It is a basic but functional reader: you can adjust font size and background color, and your reading position syncs across devices if you are logged into the same account. This is the feature that removes the "copy files to your phone" problem entirely for most people. You open Safari or Chrome on your phone, navigate to your Calibre-Web address, find a book, and start reading.
For books you want to read on a dedicated e-reader, the download button fetches the file directly to your device. If the book is in a format your reader does not support, and Calibre's conversion tool is installed on the server, you can request a format conversion from the same page before downloading.
Send-to-Kindle is a practical feature for Kindle owners. Amazon allows you to send ebook files to your Kindle via email, and the device receives them over its wireless connection. Calibre-Web hooks into this: you configure your Kindle's personal email address in Calibre-Web's settings, and a "Send to Kindle" button appears on every book's detail page. Click it and the book shows up on your Kindle in a minute. This works for books in formats Kindle supports; Calibre's conversion tool handles converting other formats before sending if needed.
OPDS support is included. OPDS stands for Open Publication Distribution System and is a standard catalog format that allows e-reader applications to browse and download books automatically from a server. Apps like Kybook (iOS), Moon+ Reader (Android), and many others can connect directly to your Calibre-Web OPDS URL, browse your full library inside the app, and download books without opening a browser. For anyone with a dedicated reading app already, OPDS is the cleaner path than using the browser interface.
User accounts let you give family members their own logins with separate reading shelves and reading progress tracking. You can set permissions per user, including whether they can upload books, download files, or only read in the browser. Reading progress syncs per account. A household where multiple people use the same library but want to track their own reading position is a supported use case out of the box.
The install experience
Docker is the recommended install method. Docker is software that packages an application and all its dependencies into a container, a portable unit that runs the same way on any server regardless of what else is installed on it.
The standard Docker Compose setup (Docker Compose is a tool that defines and starts multi-container setups with a single configuration file) looks like this:
services:
calibre-web:
image: lscr.io/linuxserver/calibre-web:latest
container_name: calibre-web
environment:
- PUID=1000 # the user ID the container runs as on your server
- PGID=1000 # the group ID (both default to 1000 on most Linux systems)
- TZ=America/New_York # your timezone, e.g. Europe/London
volumes:
- /path/to/config:/config
- /path/to/your/calibre/library:/books
ports:
- 8083:8083
restart: unless-stopped
The two paths you need to set are the config directory (where Calibre-Web stores its own settings database) and the books directory, which must point to the folder where Calibre keeps its library. On most systems, Calibre's library folder is named "Calibre Library" and contains the metadata.db file alongside subfolders for each author. Point the books volume at that exact folder.
After starting the container, the setup wizard at http://localhost:8083 asks you for the path to metadata.db inside the container. Because you mounted the library at /books in the configuration above, the path inside the container is /books/metadata.db. Set that path, click submit, and your library loads immediately.
The default admin credentials are admin/admin123, which you change in the first settings visit. From that point the application is functional with no further configuration required.
Running this on a Raspberry Pi or NAS requires the same Docker setup with architecture-appropriate images. The LinuxServer.io image used above supports both AMD64 (the processor architecture used in standard desktop PCs and most cloud servers) and ARM64 (the architecture used in Raspberry Pi 4 and newer, and some NAS devices), so the same Compose file works on either without changes.
One thing to know before starting: Calibre-Web is read-only for the library by default. Adding new books still happens in Calibre on your desktop. You can enable uploads in Calibre-Web's settings, which allows uploading ebook files directly through the browser, but those uploads still go into the library folder and Calibre picks them up next time it opens the folder. The two applications are always working from the same files, not competing databases.
Where it fits and what to compare it to
The realistic alternatives for accessing your own ebook collection are limited and mostly involve accepting restrictions you may not want.
Kindle Unlimited costs $11.99 per month and gives you access to Amazon's lending catalog, not your own collection. If you buy ebooks from Amazon, they live in your Kindle account and are accessible on any Kindle device or app. What it does not do is give you web-based access to your personal EPUB files, your legally converted ebooks, or books you acquired from sources other than Amazon. Calibre-Web serves your collection; Kindle Unlimited gives you Amazon's catalog on Amazon's terms.
Libby is a free app that connects to your local library system and lets you borrow ebooks from your library's digital catalog. It is excellent for what it does but limited to whatever your library has licensed. Your personal Calibre collection is not involved.
Reading from Calibre directly is the baseline that Calibre-Web replaces. Calibre's desktop app includes a viewer and can serve your library over the local network, but the built-in content server is basic. It is not designed for multi-user access, does not have a polished mobile browser experience, and lacks the OPDS catalog, Kindle send, and user account features that make Calibre-Web worth running as a separate service.
Kavita is an alternative self-hosted reading server worth knowing about, particularly if your library includes manga or comic book archives rather than primarily EPUB ebooks. Kavita has a more polished reading interface for those formats. For a primarily prose ebook library organized in Calibre, Calibre-Web's direct Calibre database integration is the cleaner choice because there is no import step.
Verdict
Install Calibre-Web if you have a Calibre library and want to read from your phone or tablet without manually transferring files. The install takes under thirty minutes if you already have Docker and a Calibre library. The result is a browser-accessible library that any device on your network can reach, with a built-in reader for in-browser reading, send-to-Kindle for e-reader delivery, and OPDS for dedicated reading apps.
The project does not try to replace Calibre. It extends your existing library workflow with browser access. Your curation habits in Calibre carry over completely because Calibre-Web is reading the same database. If you add a book in Calibre tonight, it appears in Calibre-Web immediately.
The one practical limitation is format support in the browser reader. The built-in reader handles EPUB well. PDF rendering in a browser is adequate but not ideal for long reading sessions on a phone. For PDFs specifically, downloading and opening in a native app is a better experience. For EPUB books, in-browser reading on mobile is genuinely comfortable.
If your household has multiple readers, the user account system handles that cleanly. Each person logs in with their own account, tracks their own reading progress, and maintains their own shelves and wishlists, all from the same shared library. No additional licenses, no per-seat fees.
The 17,792 stars and GPL-3.0 license reflect a project that has been in stable use across the home server community for years. It solves one specific problem well: your Calibre library, available everywhere.