mirrors/calibre-web
1
0
Fork 0
mirror of https://github.com/janeczku/calibre-web synced 2024-10-31 23:26:20 +00:00
Code Issues Releases Wiki Activity

Cleaning up formatting of 'Additional Issues and Considerations:' section.

avni-student 2024-10-08 22:58:51 -04:00
parent 1b2a2c1f03
commit 3ad97776ec
1 changed files with 14 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
Manual-Installation.md

@ -12,7 +12,7 @@ _These instructions assume a Debian-based Linux distribution (Ubuntu, Raspberry
- `apt install git imagemagick python3-netifaces python3-pip python3-venv python3-cryptography`
**PRO TIPS**:
- On **Ubuntu** and **Debian**, `python3-cryptography` is installed by default, unlike on Raspberry Pi OS.
- On **Ubuntu** and **Debian**, `python3-cryptography` is installed by default, unlike on **Raspberry Pi OS**.
- Installing `python3-cryptography` may not be required if you install a newer version of `cryptography` using pip, as described in Step 6.
3. **Download and extract Calibre-Web:**
@ -44,20 +44,21 @@ _These instructions assume a Debian-based Linux distribution (Ubuntu, Raspberry
#### Additional Issues and Considerations:
**Raspberry Pi (Raspberry Pi OS)**:
Depending on your version of pip, the installation might fail with `Failed to build cryptography`. If you encounter this issue, try:
1. Updating pip:
- `./venv/bin/python3 -m pip install --upgrade pip`
2. If the error persists, install `cargo`:
- `apt install cargo`
3. Then, try installing Calibre-Web again.
1. **Raspberry Pi (Raspberry Pi OS)**:
**Ubuntu**:
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`
1. Depending on your version of pip, the installation might fail with `Failed to build cryptography`.
- If you encounter this issue, try updating pip:
- `./venv/bin/python3 -m pip install --upgrade pip`
- If the error persists, install `cargo`:
- `apt install cargo`
- Then, try installing Calibre-Web again.
**Configuration Files**:
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.
2. **Ubuntu**:
1. 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`
3. **Configuration Files**:
1. 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.
---