mirrors/calibre-web
1
0
Fork 0
mirror of https://github.com/janeczku/calibre-web synced 2025-02-07 14:40:08 +00:00
Code Issues Releases Wiki Activity

Accurate instructions for manual installation on Linux

Blondel MONDESIR 2024-10-03 11:04:11 -04:00
parent 676bc5b60d
commit a6c1683676
1 changed files with 15 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
Manual-Installation.md

@ -2,23 +2,31 @@
If you want to manually install Calibre-Web (“from source”), follow the procedure below. If you want to manually install Calibre-Web (“from source”), follow the procedure below.
1. **Ensure you have pip, venv, and cryptography installed**. 1. **Install pip, venv, and cryptography (optional)**
- Install `pip`, `venv`, and `cryptography` for your Python version using your package manager (e.g., apt for Debian-based distributions). Make sure you have pip and venv installed for your Python version. Install them via your distribution's package manager (e.g., apt for Debian-based distributions).
- `sudo apt install python3-pip python3-venv python3-cryptography`
- Alternatively, you can install the `cryptography` package inside the virtual environment for a more up-to-date version:
- `./venv/bin/python3 -m pip install cryptography`
2. **Go to the folder where you want to install Calibre-Web**, e.g., - `sudo apt install imagemagick python3-netifaces python3-pip python3-venv`
**PRO TIPS**:
- On **Ubuntu** and **Debian**, `python3-cryptography` is installed by default.
- On **Raspberry Pi OS**, you will need to install `python3-cryptography` manually:
- `sudo apt install python3-cryptography`
- Installing `python3-cryptography` is not required if you plan to install a newer version using pip in Step 5.
2. **Navigate to the folder where you want to install Calibre-Web**, e.g.,
- `cd /opt/calibre-web` - `cd /opt/calibre-web`
3. **Create a virtual environment** for Calibre-Web in the current folder: 3. **Create a virtual environment** for Calibre-Web in the current folder:
- `python3 -m venv venv` - `python3 -m venv venv`
4. **Download and extract Calibre-Web** into the current folder (in this example, `/opt/calibre-web`) from the [releases page on Github](https://github.com/janeczku/calibre-web/releases). 4. **Download and extract Calibre-Web** into the current folder (in this example `/opt/calibre-web`) from the [releases page on Github](https://github.com/janeczku/calibre-web/releases).
5. **Install dependencies** by running: 5. **Install dependencies** by running:
- `./venv/bin/python3 -m pip install -r requirements.txt` - `./venv/bin/python3 -m pip install -r requirements.txt`
- **Optional: Install a more recent version of `cryptography`** (if not using the OS version):
- `./venv/bin/python3 -m pip install cryptography`
6. **Execute Calibre-Web** with the command: 6. **Execute Calibre-Web** with the command:
- `./venv/bin/python3 cps.py` - `./venv/bin/python3 cps.py`
(or use `nohup ./venv/bin/python3 cps.py` if you want to exit the terminal window) (or use `nohup ./venv/bin/python3 cps.py` if you want to exit the terminal window)