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

25
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` - `apt install git imagemagick python3-netifaces python3-pip python3-venv python3-cryptography`
**PRO TIPS**: **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. - 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:** 3. **Download and extract Calibre-Web:**
@ -44,20 +44,21 @@ _These instructions assume a Debian-based Linux distribution (Ubuntu, Raspberry
#### Additional Issues and Considerations: #### Additional Issues and Considerations:
**Raspberry Pi (Raspberry Pi OS)**: 1. **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.
**Ubuntu**: 1. Depending on your version of pip, the installation might fail with `Failed to build cryptography`.
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: - 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.
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` - `./venv/bin/python3 -m pip install --system -r requirements.txt`
**Configuration Files**: 3. **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. 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.
--- ---