diff --git a/Manual-Installation.md b/Manual-Installation.md index 8ef706d..e79d71c 100644 --- a/Manual-Installation.md +++ b/Manual-Installation.md @@ -2,23 +2,31 @@ If you want to manually install Calibre-Web (“from source”), follow the procedure below. -1. **Ensure you have pip, venv, and cryptography installed**. - - Install `pip`, `venv`, and `cryptography` for your Python version using your package manager (e.g., apt for Debian-based distributions). - - `sudo apt install python3-pip python3-venv python3-cryptography` - - Alternatively, you can install the `cryptography` package inside the virtual environment for a more up-to-date version: - - `./venv/bin/python3 -m pip install cryptography` +1. **Install pip, venv, and cryptography (optional)** + Make sure you have 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` -2. **Go to the folder where you want to install Calibre-Web**, e.g., + **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. + +2. **Navigate to the folder where you want to install Calibre-Web**, e.g., - `cd /opt/calibre-web` 3. **Create a virtual environment** for Calibre-Web in the current folder: - `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). +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): + - `./venv/bin/python3 -m pip install cryptography` + 6. **Execute Calibre-Web** with the command: - `./venv/bin/python3 cps.py` (or use `nohup ./venv/bin/python3 cps.py` if you want to exit the terminal window)