mirrors/calibre-web
1
0
Fork 0
mirror of https://github.com/janeczku/calibre-web synced 2025-12-29 18:29:04 +00:00
Code Issues Releases Wiki Activity
Page: How To: Install Calibre Web in Linux
Pages
Additional Configuration for Kindle E Mail Automatically import new books (Linux) Command Line Interface Configuration Dependencies in Calibre Web Linux and Windows Deploy on Easypanel Developer's corner Extend Features FAQ G Drive Setup Home How To: Install on True NAS How To: Install Calibre Web in Linux How To: Install Calibre Web on a Cloud Provider How To: Windows Installation Kobo Integration LDAP Login Manual Installation OAuth Login with Github and Google Setup Mailserver Setup Reverse Proxy Setup Service on Linux Translation Status
Clone
How To: Install Calibre Web in Linux
Francesco Di Nucci edited this page 2025-12-03 12:08:17 +01:00
Table of Contents

ToC

Alpine Linux

Tested on Alpine Linux 3.21.x Virtual

Install Python 3.x packages (select virtualenv only if you plan to use it)

doas apk add python3 py3-pip py3-virtualenv py3-virtualenv-pyc

Install packages to compile wheel extensions

doas apk add build-base linux-headers python3-dev

Create a virtual environment with venv or virtualenv

# venv
doas python3 -m venv /opt/calibre-web
# virtualenv
doas python3 -m virtualenv /opt/calibre-web

Install calibre-web in the venv

/opt/calibre-web/bin/python3 -m pip install calibreweb

Run calibre-web

/opt/calibre-web/bin/python3 -m calibreweb
# alternatively
/opt/calibre-web/bin/cps

Linux Mint

Linux Mint 20

Before installing Calibre-Web we have to install component: python3-pip

  1. We open a terminal inside the Calibre-Web directory

  2. We run the following at the terminal:

    • sudo apt install python3-pip

  3. Go to the folder where you want to install calibre-web, e.g. /opt/calibre-web

  4. Install virtual environment and create one for calibre web (module virtualenv will also work as alternative to venv module)

    • python3 -m pip install venv

    • python3 -m venv venv

  5. Execute the installation of Calibre-Web with newly created virtual python environment:

    • ./venv/bin/python3 -m pip install calibreweb

  6. We run Calibre-Web (using the python from the newly created virtual python environment) with:

    • ./venv/bin/cps or ./venv/bin/python3 -m calibreweb

DANGER: Never close the terminal. To start Calibre-Web at startup, please take a look at How to Start Calibre-Web as Service

  1. Launch web browser and write http://localhost:8083
    Default admin login:
    Username: admin
    Password: admin123

  2. Calibre-Web running

Important (if not started as service): If we turn on or reboot Linux Mint we have to open a terminal inside the Calibre-Web directory and run: [folder where calibre web is installed]/venv/bin/python3 cps.py

Linux Mint 19

Before installing Calibre-Web we have to install several components: python3-pip, python3-dev, setuptools, wheel.

  1. We open a terminal inside the Calibre-Web directory

  2. We run the following at the terminal:

    • sudo apt install python3-pip

    • sudo apt install python3-dev

    • python3 -m pip install --upgrade setuptools

    • python3 -m pip install wheel

  3. Go to the folder where you want to install calibre-web, e.g. /opt/calibre-web

  4. Install virtual environment and create one for calibre web (module virtualenv will also work as alternative to venv module)

    • python3 -m pip install venv

    • python3 -m venv venv

  5. Execute the installation of Calibre-Web with newly created virtual python environment:

    • ./venv/bin/python3 -m pip install calibreweb

  6. We run Calibre-Web (using the python from the newly created virtual python environment) with:

    • ./venv/bin/cps or ./venv/bin/python3 -m calibreweb

DANGER: Never close the terminal. To start Calibre-Web at startup, please take a look at How to Start Calibre-Web as Service

7 - Launch web browser and write http://localhost:8083
Default admin login:
Username: admin
Password: admin123

8 - Calibre-Web running

Remark: All config files (settings database, logfiles) are stored in /homes/[username]/.calibre-web. Additional config files, such as the config files for gdrive and gmail have to be placed there too.