diff --git a/Manual-Installation.md b/Manual-Installation.md index 55d4d41..2fc3d26 100644 --- a/Manual-Installation.md +++ b/Manual-Installation.md @@ -4,31 +4,32 @@ If you want to manually install Calibre-Web (“from source”), follow the inst _These instructions assume a Debian-based Linux distribution (Ubuntu, Raspberry Pi OS...)_ -1. **Install git, imagemagick, netifaces, pip, venv, and cryptography:** +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, 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 4. 2. **Download and extract Calibre-Web:** + - `sudo mkdir -p /opt` - `cd /opt` - - `git clone https://github.com/janeczku/calibre-web` + - `sudo git clone https://github.com/janeczku/calibre-web` - `cd calibre-web` 3. **Create a virtual environment** for Calibre-Web: - - `python3 -m venv venv` + - `sudo python3 -m venv venv` 4. **Install dependencies** by running: - - `./venv/bin/python3 -m pip install -r requirements.txt` + - `sudo ./venv/bin/python3 -m pip install -r requirements.txt` **PRO TIP:** - **If you want a more recent version of `cryptography`** than your OS offers: - - `./venv/bin/python3 -m pip install cryptography` + - `sudo ./venv/bin/python3 -m pip install cryptography` 5. **Run Calibre-Web** with the command: - - `./venv/bin/python3 cps.py` + - `sudo ./venv/bin/python3 cps.py` **PRO TIP:** - Or use `nohup ./venv/bin/python3 cps.py` if you want to exit the terminal window. @@ -37,19 +38,19 @@ _These instructions assume a Debian-based Linux distribution (Ubuntu, Raspberry #### Additional Issues and Considerations: -**Raspberry Pi (Raspberry Pi OS)**: +**Raspberry Pi (Raspberry Pi OS)**: Depending on your version of pip, the installation might fail with `Failed to build cryptography`. If you encounter this issue, try: -1. Updating pip: - - `./venv/bin/python3 -m pip install --upgrade pip` -2. If the error persists, install `cargo`: +1. Updating pip: + - `sudo ./venv/bin/python3 -m pip install --upgrade pip` +2. If the error persists, install `cargo`: - `sudo apt install cargo` 3. Then, try installing Calibre-Web again. -**Ubuntu**: +**Ubuntu**: 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` + - `sudo ./venv/bin/python3 -m pip install --system -r requirements.txt` -**Configuration Files**: +**Configuration Files**: All configuration files (settings database, log files) are stored in the Calibre-Web root folder (in this example, `/opt/calibre-web`). Additional config files, such as those for Google Drive or Gmail integration, should be placed there as well. --- @@ -75,5 +76,5 @@ On Windows, pip and venv are included with the basic Python installation. Follow 6. **Run Calibre-Web** with the command: - `.\venv\Scripts\python3.exe cps.py` -**Configuration Files**: +**Configuration Files**: All configuration files (settings database, log files) are stored in the Calibre-Web root folder (in this example, `c:\calibre-web`). Additional config files (e.g., for Google Drive or Gmail) should also be placed here. \ No newline at end of file