Skip to main content


Calibre is a cross-platform free and open-source suite of e-book software. Calibre supports organizing existing e-books into virtual libraries, displaying, editing, creating and converting e-books, as well as syncing e-books with a variety of e-readers.

  • For more information about this app, follow this link.

Initial Setup

  • Calibre is currently provided as a BETA application.
  • Connect to your service via SSH.
  • Execute the following command:
app-calibre install -p <your-password>
  • Make sure to replace <your-password> with a strong password of your choice.
  • Note that the installation can take more than 1 minute, so please be patient.
  • When the installation has finished, copy the URL from the terminal output, e.g.
    • In the URL username and hostname will be replaced with your username and hostname.

To upgrade Calibre you need to include your password with the upgrade command: app-calibre upgrade -p [your-password]


  • Once you have installed Calibre, paste the copied URL into your web browser to access the web UI, you will be greeted by a login form. Log in with your username and the password you set during the installation.
  • Our Calibre installation comes with a pre-configured library:
    • ~/media/Calibre Library
  • You could choose a different path within your home directory, though the directory needs to be created and be empty OR include a Calibre database library from a previous installation.

  • In this guide, we will be using the default path ~/media/Calibre Library.
  • Click the Next button.

  • Choose the generic device you will be using to read your ebooks.
  • Click the Next button.

  • Click the Finish button to complete the setup of Calibre.

Add Books

  • Books can be added to the database library by manually adding them into default library path, in this guide that would be ~/media/Calibre Library.
  • Books can also be manually added by clicking the Add Books button within the Calibre UI.

  • Next, choose how you want to add books, in this guide we will choose Add books from a single folder
  • Note that the file dialog defaults to the /config directory of the docker. Navigate to /home/username to enter your home directory. The next time you use the file dialog, click the file path and you will have the option to select previously selected paths (e.g. your home directory).

  • Navigate to the location where your book is located, mark it and click Open.

  • If done successfully, you should see your book added to the library. To read it, simply double-click on it or click the View button in the top bar.
  • However, you will have a better reading experience from using Calibre-Web.