1
0
mirror of https://github.com/janeczku/calibre-web synced 2024-10-31 23:26:20 +00:00

Make instructions more accurate by adding imagemagick and netifaces

Blondel MONDESIR 2024-10-03 11:15:27 -04:00
parent a6c1683676
commit 765da6d8ee

@ -1,10 +1,10 @@
### Manual installation on Linux or MacOS
### Manual Installation on Linux or MacOS
If you want to manually install Calibre-Web (“from source”), follow the procedure below.
1. **Install pip, venv, and cryptography (optional)**
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).
1. **Install imagemagick, netifaces, pip, venv, and cryptography (optional)**
Make sure you have `imagemagick`, `netifaces`, `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 imagemagick python3-netifaces python3-pip python3-venv`
**PRO TIPS**:
@ -13,13 +13,13 @@ If you want to manually install Calibre-Web (“from source”), follow the proc
- `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.,
2. **Navigate to the folder where you want to install Calibre-Web**, e.g.:
- `cd /opt/calibre-web`
3. **Create a virtual environment** for Calibre-Web in the current folder:
- `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:
- `./venv/bin/python3 -m pip install -r requirements.txt`
@ -27,7 +27,7 @@ If you want to manually install Calibre-Web (“from source”), follow the proc
- **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. **Run Calibre-Web** with the command:
- `./venv/bin/python3 cps.py`
(or use `nohup ./venv/bin/python3 cps.py` if you want to exit the terminal window)
@ -42,11 +42,11 @@ Depending on your version of pip, the installation might fail with `Failed to bu
3. Then, try installing Calibre-Web again.
**Ubuntu**:
On some Ubuntu versions, you may see the error `can't combine user with prefix`. This is a [known bug](https://github.com/pypa/pip/issues/3826) and can be resolved by installing the requirements with the `--system` flag:
On some Ubuntu versions, you may encounter the error `can't combine user with prefix`. This is a [known bug](https://github.com/pypa/pip/issues/3826) and can be resolved by installing the requirements with the `--system` flag:
- `./venv/bin/python3 -m pip install --system -r requirements.txt`
**Configuration Files**:
All configuration files (settings database, log files) are stored in the Calibre-Web root folder (in this example, `/opt/calibre-web`). Any additional config files, such as those for Google Drive or Gmail integration, should be placed there as well.
All configuration files (settings database, log files) are stored in the Calibre-Web root folder (in this example, `/opt/calibre-web`). Additional config files, such as those for Google Drive or Gmail integration, should be placed there as well.
---
@ -68,7 +68,7 @@ On Windows, pip and venv are included with the basic Python installation. Follow
- `.\venv\Scripts\python3.exe -m pip install -r requirements.txt`
(Executed from the `c:\calibre-web` folder.)
6. **Execute Calibre-Web** with the command:
6. **Run Calibre-Web** with the command:
- `.\venv\Scripts\python3.exe cps.py`
**Configuration Files**: