Autocaliweb

[!IMPORTANT] Since 1st Febuary 2026 the development of Autocaliweb moved to Codeberg -> gelbphoenix/autocaliweb on Codeberg.org

Autocaliweb is a web app that offers a clean and intuitive interface for browsing, reading, and downloading eBooks using a valid Calibre database.

<details> <summary><strong>Table of Contents</strong> (click to expand)</summary>

1. About
2. Features
3. Installation
   • Installation via Docker (recommended)
   • Manual installation without Docker (on your own risk)
   • Proxmox VE Script
   • After Installation
   • Deploy Requirements
4. Troubleshooting
5. Contributor Recognition
6. Documentation
7. Contributing to Autocaliweb

</details>

This software is a fork of Calibre-Web and Calibre-Web Automated and licensed under the GPL v3 License.

Features

• Modern and responsive Bootstrap 3 HTML5 interface
• Full graphical setup
• Comprehensive user management with fine-grained per-user permissions
• Admin interface
• Multilingual user interface supporting 20+ languages
• OPDS feed for eBook reader apps
• Advanced search and filtering options
• Custom book collection (shelves) creation
• eBook metadata editing and deletion support
• Metadata download from various sources (extensible via plugins)
• eBook conversion through Calibre binaries
• eBook download restriction to logged-in users
• Public user registration support
• Send eBooks to E-Readers
• Sync Kobo devices with your Calibre library
• In-browser eBook reading support for multiple formats
• Upload new books in various formats, including audio formats
• Calibre Custom Columns support
• Content hiding based on categories and Custom Column content per user
• Self-update capability
• "Magic Link" login for easy access on eReaders
• LDAP, Google/GitHub OAuth, and proxy authentication support
• Auto Ingest, Conversion, Metadata and Cover Enforcement and Backup services
• Automatic EPub Fixer service
• Auto-detection of your library
• Automatic Setup
• Server Stats tracking
• Easy theme switching
• Batch edits of books
• ISBNDB, Amazon JP and Hardcover as additional metadata providers
• Syncing reading process to Hardcover.app (Only with Kobo E-Readers)
• Split library support
• Support for CLI compatible Calibre plugins
• Support for syncing with the KOReader document viewer
• Setting Automerge option
• Automatically fetch metadata for newly added books
• Automatically send new books to your E-Reader

Features only in Autocaliweb

• Usage of DOCKER_MODS from sources like linuxserver.io and others
• Listing and caching of Author information and other books from Goodreads or Hardcover
• User en- or disabling of the Kobo Sync and Overdrive tabs as well as the Instapaper integration when using Kobo sync
• Support for custom OIDC providers (with support for /.well-known/openid-configuration)
• Support for manual installation (without docker specific features)
• LitRes as metadata provider
• Multi email selection for the Send eBooks to E-Readers function
• Management system for duplicate books
• Generate generic covers for books

Installation

[!NOTE] Installation on Windows with Docker Desktop is not supported. Installation on Windows Subsystem for Linux (WSL) is on your own risk.

Installation via Docker (recommended)

Quick Install

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://raw.githubusercontent.com/gelbphoenix/autocaliweb/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

And that's you off to the races! Continue with the things after installation.

Using Docker compose:

services:
  autocaliweb:
    image: gelbphoenix/autocaliweb:latest
    container_name: autocaliweb
    restart: unless-stopped
    ports:
      - "8083:8083"
    environment:
      - TZ=Etc/UTC # Change to your specific timezone (e.g. Europe/Berlin, America/Denver)
      - PUID=1000
      - PGID=1000
    volumes:
      - /path/to/config:/config
      - /path/to/book/ingest:/acw-book-ingest
      - /path/to/library:/calibre-library
    stop_signal: SIGINT
    stop_grace_period: 15s

Manual installation without Docker (on your own risk)

If you want to install Autocaliweb on your server without setting up Docker and Docker compose you can follow these steps (For an extensive installation and the uninstall guide look at the relating wiki article):

1. Download the manual_install_acw.sh file with the following command and check it:

curl -Lo ./manual_install_acw.sh https://github.com/gelbphoenix/autocaliweb/raw/refs/heads/main/scripts/manual_install_acw.sh

2. Make manual_install_acw.sh executeable and run it as root:

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

3. Follow now the next steps that are shown after install_autocaliweb run successfully

Proxmox VE Script

[!NOTE] This script was created by and maintained by team of the Proxmox VE Helper-Scripts. The page of the script is found here and support for the script is provided by that team.

To install Autocaliweb on Proxmox VE you can also use this script from the Proxmox VE Helper-Scripts:

<details> <summary>GitHub</summary>

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

</details> <details> <summary>Gitea (Look on the page for the script for when you have to use this link)</summary>

bash -c "$(curl -fsSL https://git.community-scripts.org/community-scripts/ProxmoxVE/raw/branch/main/ct/autocaliweb.sh)"

</details>

You can (and generally should) check and understand external scripts.

Deploy Requirements

For the deployment via docker

• Docker version 27.5.1 (minimum)
• Docker Compose version 2.33.1 (minimum)

For the manual installation

See the requirements here

For the Proxmox VE Script

• An updated Proxmox VE install

After Installation

1. Access Autocaliweb: Open your browser and navigate to: http://localhost:8083 (http://localhost:8083/opds for the OPDS catalog).
2. Log in with the default admin credentials:

   Username: admin
   Password: admin123
   

3. Configure your Autocaliweb instance via the Admin Page

• A guide to what all of the stock CW Settings do can be found here
• Make sure Enable Uploads is enabled in Settings -> Basic Configuration -> Feature Configuration

4. Google Drive Integration: For hosting your Calibre library on Google Drive, refer to the Google Drive integration guide of Calibre-Web.

[!IMPORTANT] > If you are migrating from Calibre-Web Automated please ensure that your cwa.db is renamed acw.db before start to load your existing settings

Troubleshooting

• Common Issues:

  • If you experience issues starting the application, check the log files located in the logs directory for error messages.
  • If eBooks fail to load, verify that the Location of Calibre database is correctly set and that the database file is accessible.

• Configuration Errors: Ensure that your Calibre database is compatible and properly formatted. Refer to the Calibre documentation for guidance on maintaining the database.

• Performance Problems:

  • If the application is slow, consider increasing the allocated resources (CPU/RAM) to your server or optimizing the Calibre database by removing duplicates and unnecessary entries.
  • Regularly clear the cache in your web browser to improve loading times.

• User Management Issues: If users are unable to log in or register, check the user permission settings in the admin interface. Ensure that registration is enabled and that users are being assigned appropriate roles.

Contributor Recognition

We would like to thank all the contributors and maintainers of Autocaliweb for their valuable input