mirrors/calibre-web
1
0
Fork 0
mirror of https://github.com/janeczku/calibre-web synced 2025-02-07 06:30:06 +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.
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).
_These instructions assume a Debian-based Linux distribution (Ubuntu, Raspberry Pi OS...)_
- `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**:
- On **Ubuntu** and **Debian**, `python3-cryptography` is installed by default.
- On **Raspberry Pi OS**, you will need to install `python3-cryptography` manually:
- `sudo apt install python3-cryptography`
- Installing `python3-cryptography` is not required if you plan to install a newer version using pip in Step 5.
- On **Ubuntu** and **Debian**, `python3-cryptography` is installed by default, unlike on Raspberry Pi OS.
- Installing `python3-cryptography` is not required if you plan to install a newer version using pip as described in Step 5.
2. **Navigate to the folder where you want to install Calibre-Web**, e.g.:
- `cd /opt/calibre-web`
2. **Download and extract 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`
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`
- **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`
6. **Run Calibre-Web** with the command: