mirrors/calibre-web
1
0
Fork 0
mirror of https://github.com/janeczku/calibre-web synced 2025-10-26 04:47:40 +00:00
Code Issues Releases Wiki Activity

Update cryptography installation. Renamed Mint to Linux Mint

Ozzie Isaacs
2024-10-28 19:05:20 +01:00
parent c4310d2bde
commit 918ae3cb21
1 changed files with 16 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
Manual-Installation.md

@@ -2,7 +2,7 @@
If you want to manually install Calibre-Web (“from source”), follow the instructions below.
_These instructions assume a Debian-based Linux distribution (Ubuntu, Raspberry Pi OS, Mint, ...)_
_These instructions assume a Debian-based Linux distribution (Ubuntu, Raspberry Pi OS, Linux Mint, ...)_
1. **Switch to user `root`**:
- `sudo -i`
@@ -22,19 +22,6 @@ _These instructions assume a Debian-based Linux distribution (Ubuntu, Raspberry
5. **Install dependencies:**
- `./venv/bin/python3 -m pip install -r requirements.txt`
**PRO TIPS**:
- If the above has trouble pip installing `cryptography` (e.g. as Raspberry Pi OS evolves, failing here almost every year!) then a valuable workaround can be to start over (from the beginning!) and **instead of Step 4.** run `apt install python3-cryptography` then `python3 -m venv venv --system-site-packages` — to give the virtual environment access to your OS's python3-cryptography.
- Just FYI on **Ubuntu** and **Debian**, `python3-cryptography` is already installed by default, unlike on **Raspberry Pi OS**.
<!-- No longer needed thanks to #3183, specifically commit "Add cryptography to requirements" = https://github.com/janeczku/calibre-web/commit/c2ffa940cd18970eb78a9379a7a6b19664b8b7e5
6. **Install `cryptography` using pip:** (this NEW step proved necessary when testing on 5 OS's on 2024-10-09: Debian 12, Debian 13, Ubuntu 24.04, Ubuntu 24.10, Raspberry Pi OS)
- `./venv/bin/python3 -m pip install cryptography` -->
<!-- **PRO TIP:**
- **If you want a more recent version of `cryptography`** than your OS offers: -->
6. **Run Calibre-Web:** _(FYI the command below does NOT come back to the prompt, and that's OK!)_
- `./venv/bin/python3 cps.py`
@@ -57,6 +44,21 @@ _These instructions assume a Debian-based Linux distribution (Ubuntu, Raspberry
- `apt install cargo`
- Then, try installing Calibre-Web again.
**PRO TIPS**:
- If the above procedure still fails (e.g. as Raspberry Pi OS evolves, failing here almost every year!) then a valuable workaround can be to start over (from the beginning!) and run `apt install python3-cryptography` then `python3 -m venv venv --system-site-packages` — to give the virtual environment access to your OS's python3-cryptography.
<!-- - Just FYI on **Ubuntu** and **Debian**, `python3-cryptography` is already installed by default, unlike on **Raspberry Pi OS**.
No longer needed thanks to #3183, specifically commit "Add cryptography to requirements" = https://github.com/janeczku/calibre-web/commit/c2ffa940cd18970eb78a9379a7a6b19664b8b7e5
6. **Install `cryptography` using pip:** (this NEW step proved necessary when testing on 5 OS's on 2024-10-09: Debian 12, Debian 13, Ubuntu 24.04, Ubuntu 24.10, Raspberry Pi OS)
- `./venv/bin/python3 -m pip install cryptography` -->
<!-- **PRO TIP:**
- **If you want a more recent version of `cryptography`** than your OS offers: -->
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`