mirrors/calibre-web
1
0
Fork 0
mirror of https://github.com/janeczku/calibre-web synced 2025-07-06 20:12:56 +00:00
Code Issues Releases Wiki Activity

Simplify instructions for newbies

Blondel MONDESIR 2024-10-08 19:21:51 -04:00
parent 765da6d8ee
commit 4985a0c4b6
1 changed files with 13 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
Manual-Installation.md

@ -2,29 +2,29 @@
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. **Install imagemagick, netifaces, pip, venv, and cryptography (optional)** _These instructions assume a Debian-based Linux distribution (Ubuntu, Raspberry Pi OS...)_
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` 1. **Install git, imagemagick, netifaces, pip, venv, and cryptography:**
- `sudo 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. - On **Ubuntu** and **Debian**, `python3-cryptography` is installed by default, unlike on Raspberry Pi OS.
- On **Raspberry Pi OS**, you will need to install `python3-cryptography` manually: - Installing `python3-cryptography` is not required if you plan to install a newer version using pip as described in Step 5.
- `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. **Download and extract Calibre-Web:**
- `cd /opt/calibre-web` - `cd /opt`
- `git clone https://github.com/janeczku/calibre-web`
- `cd calibre-web`
3. **Create a virtual environment** for Calibre-Web in the current folder: 3. **Create a virtual environment** for Calibre-Web:
- `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).
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): **PRO TIP:**
- **If you want a more recent version of `cryptography`** than your OS offers:
- `./venv/bin/python3 -m pip install cryptography` - `./venv/bin/python3 -m pip install cryptography`
6. **Run Calibre-Web** with the command: 6. **Run Calibre-Web** with the command: