diff --git a/Manual-Installation.md b/Manual-Installation.md index 5e9cd92..28caeeb 100644 --- a/Manual-Installation.md +++ b/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: