# Autocaliweb

> Self-hosted, open-source web app to browse, read and manage eBooks, eComics and PDFs on a Calibre database, with OPDS, Kobo sync and automated ingest and conversion.

- **Category:** [E-book Management](https://selfhost.directory/e-book-management)
- **Source model:** Open source
- **Latest version:** v0.12.11
- **Author:** gelbphoenix
- **Platforms:** Docker Compose, Proxmox, Systemd
- **Ports:** 8083 (Web UI and OPDS catalog (http://localhost:8083, /opds for the catalog))
- **Requires:** Calibre (binaries), Calibre database (metadata.db), Kepubify (optional), Unrar (optional), Redis / Valkey / Memcached (optional)
- **Tags:** LDAP, Ebooks, PDF, Metadata, Comics, Kobo, Opds, OIDC, Koreader, Ereader, Calibre Web

## Docker images

- [`gelbphoenix/autocaliweb`](https://hub.docker.com/r/gelbphoenix/autocaliweb)

## What is Autocaliweb?

Autocaliweb is a web application for anyone who keeps an eBook collection in a Calibre database and wants to reach it from a browser or an e-reader. It is a fork of Calibre-Web and Calibre-Web Automated, and it leans into automation: books dropped into an ingest folder get converted, metadata and covers fetched, duplicates managed and backups taken on their own, with an EPub fixer and library auto-detection plus automatic setup on top. Day-to-day features include an OPDS catalog, in-browser reading of several formats, sending books to e-readers, Kobo device sync, shelves with bulk editing, metadata editing, custom columns, per-user content hiding and fine-grained permissions. Metadata can be pulled from many providers, with ISBNDB, Amazon JP, Hardcover and LitRes added on top of the upstream sources, and reading progress can be mirrored to Hardcover when a Kobo is used. Sign-in works via local accounts, public registration, magic links, LDAP, Google/GitHub OAuth, proxy auth or a custom OIDC provider. Deployment options are the published Docker image with a compose file, a manual Linux installer that sets up a systemd service, or a Proxmox VE helper script; the interface listens on port 8083. Docker Desktop on Windows is unsupported, the project's own documentation is called unfinished, and versions are still below 1.0 (GPL v3 licensed).

## Should you self-host Autocaliweb?

Autocaliweb scores **49/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#9 of 9** in [E-book Management](https://selfhost.directory/e-book-management).

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available.

Its closest alternative on selfhost.directory is [koodo-reader](https://selfhost.directory/project/koodo-reader) (78/100, 28 945 stars). It scores higher overall, so compare the two before you pick. [See Autocaliweb vs koodo-reader side by side.](https://selfhost.directory/compare/autocaliweb-vs-koodo-reader)

## Features

- Automated ingest and housekeeping
- Book conversion
- Duplicate book management
- In-browser Reading
- Kobo device sync
- Magic link login
- Metadata editing and fetching
- OPDS Catalog
- Per-user content hiding
- Self-update
- Send books to e-readers
- Shelves / collections
- Theme switching
- User management and permissions

## How to install Autocaliweb

### Install Autocaliweb with Docker Compose

1. Download the Docker Compose template file to the folder where Autocaliweb should have it's data (e.g. /opt/autocaliweb) using the command below:

```
curl -Lo ./docker-compose.yml https://codeberg.org/gelbphoenix/autocaliweb/raw/branch/main/docker-compose.yml
```

2.  Edit the compose file using the comments to help, filling in your Timezone and desired binds

3.  Navigate to where you downloaded the Compose file and run:

```
docker compose up -d
```

Note: Recommended method. Installation on Windows with Docker Desktop is not supported.

### Install Autocaliweb with Proxmox

Requirements: An updated Proxmox VE install

```bash
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/autocaliweb.sh)"
```

Note: Script created and maintained by the Proxmox VE Helper-Scripts team; requires an updated Proxmox VE install.

### Install Autocaliweb with Systemd

Environment variables:

```
ACW_INSTALL_DIR, ACW_CONFIG_DIR, LIBRARY_DIR, INGEST_DIR, ACW_USER, ACW_GROUP, REPO_HOST
```

```bash
curl -Lo ./manual_install_acw.sh https://codeberg.org/gelbphoenix/autocaliweb/raw/refs/heads/main/scripts/manual_install_acw.sh
```

```bash
sudo chmod +x ./manual_install_acw.sh && sudo ./manual_install_acw.sh
```

Note: Default install path /opt/autocaliweb; service managed via `sudo systemctl start autocaliweb`. On your own risk per the README.

## Autocaliweb alternatives

- [seblucas-cops](https://selfhost.directory/project/seblucas-cops): A self-hosted PHP application that serves Calibre ebook libraries through OPDS feeds and a responsive web catalog, offering a lighter alternative to Calibre's own server. (compare: https://selfhost.directory/compare/autocaliweb-vs-seblucas-cops)
- [grimmory](https://selfhost.directory/project/grimmory): Open-source self-hosted digital library for ebooks, comics, and audiobooks with a built-in browser reader, OPDS, Kobo and KOReader sync, and automatic metadata fetching. (compare: https://selfhost.directory/compare/autocaliweb-vs-grimmory)
- [BookLore](https://selfhost.directory/project/booklore): BookLore is a self-hosted, open-source digital library for EPUBs, PDFs and comics, offering smart shelves, automatic metadata, OPDS, Kobo sync, and a built-in reader. (compare: https://selfhost.directory/compare/autocaliweb-vs-booklore)
- [bookorbit](https://selfhost.directory/project/bookorbit): Open-source, self-hosted reading hub: built-in readers for ebooks, comics and audiobooks, metadata enrichment, and two-way Kobo/KOReader sync across your devices. (compare: https://selfhost.directory/compare/autocaliweb-vs-bookorbit)
- [Bookshelf](https://selfhost.directory/project/bookshelf-2): Self-hosted ebook library for EPUBs/PDFs with OPDS catalog for e-readers, browser readers, and multi-reader profiles. Runs on Cloudflare R2 or local filesystem. (compare: https://selfhost.directory/compare/autocaliweb-vs-bookshelf-2)
- [Codex](https://selfhost.directory/project/codex): Codex is a self-hosted, open-source comic archive browser and reader supporting CBZ, CBR, CB7, CBT, PDF with OPDS, OIDC, and advanced library management. (compare: https://selfhost.directory/compare/autocaliweb-vs-codex)
- [shelfmark](https://selfhost.directory/project/shelfmark): Open-source self-hosted web UI to search, request, and download ebooks and audiobooks from Prowlarr, Usenet, IRC, or direct sources, with multi-user requests. (compare: https://selfhost.directory/compare/autocaliweb-vs-shelfmark)
- [KoShelf](https://selfhost.directory/project/koshelf): Self-hosted web dashboard combining KOReader notes, highlights, and reading statistics with library browsing, in-app reader, calendar, and optional auth. (compare: https://selfhost.directory/compare/autocaliweb-vs-koshelf)

## More in E-book Management

- [BookLore](https://selfhost.directory/project/booklore): BookLore is a self-hosted, open-source digital library for EPUBs, PDFs and comics, offering smart shelves, automatic metadata, OPDS, Kobo sync, and a built-in reader.
- [Calibre Web](https://selfhost.directory/project/calibre-web): Open-source, self-hosted front-end for browsing, reading, converting and sharing ebooks from a Calibre database, with OPDS access and per-user permissions.
- [docker-calibre-web](https://selfhost.directory/project/docker-calibre-web): Self-hosted web application for managing and reading eBooks through a clean browser interface. Works with Calibre databases and supports Google Drive integration.
- [DVinyl](https://selfhost.directory/project/dvinyl): DVinyl is a modern, self-hostable collection manager designed for physical media enthusiasts. From Vinyls and CDs to Books, Movies & Video games catalog, value and organize your entire physical library through a single, customizable interface.
- [ebook2audiobook---Legacy](https://selfhost.directory/project/ebook2audiobook-legacy): Self-hosted, open-source converter that turns ebooks and PDFs into audiobooks using multiple TTS engines, voice cloning, OCR and 1158 languages.
- [Kavita](https://selfhost.directory/project/kavita): Self-hosted, open-source reading server that organizes and serves your comics, manga, ebook and PDF collection with built-in readers, OPDS and OIDC multi-user logins.
- [Kindle Comic Converter](https://selfhost.directory/project/kcc): Open-source, self-hosted comic and manga converter turning CBZ, PDF or image folders into margin-free MOBI, EPUB, KEPUB or PDF for Kindle, Kobo and reMarkable readers.
- [koodo-reader](https://selfhost.directory/project/koodo-reader): Open-source, cross-platform ebook manager and reader you can self-host with Docker; reads EPUB, PDF, MOBI and CBZ, with notes, OPDS and cloud sync.
- [LANraragi](https://selfhost.directory/project/lanraragi): Web application for archival and reading of manga/doujinshi. Lightweight and Docker-ready for NAS/servers.
- [Libratory](https://selfhost.directory/project/libratory): Libratory turns PDFs into M4B audiobooks with chapter markers, read-along highlighting, and bilingual editions. Self-hosted with offline-first TTS and AI.
- [Librum](https://selfhost.directory/project/librum): A cross-platform, open-source e-book reader and library manager that syncs your books across devices and can be self-hosted with your own Librum-Server backend.
- [openbooks](https://selfhost.directory/project/openbooks): Self-hosted eBook downloader for IRC Highway. Web server mode and CLI mode. Deploy via Docker or binaries.

## Links

- [Homepage](https://codeberg.org/gelbphoenix/autocaliweb)
- [Wiki documentation](https://codeberg.org/gelbphoenix/autocaliweb/wiki)
- [Patreon](https://gelbphoenix.link/patreon)
- [Ko-fi](https://gelbphoenix.link/ko-fi)
- [Docker Hub image](https://hub.docker.com/r/gelbphoenix/autocaliweb)

---
Source: https://selfhost.directory/project/autocaliweb