diff --git a/Manual-Installation.md b/Manual-Installation.md index 083a274..9e68e45 100644 --- a/Manual-Installation.md +++ b/Manual-Installation.md @@ -2,18 +2,14 @@ If you want to manually install Calibre-Web (“from source”), follow the instructions below. -_These instructions assume a Debian-based Linux distribution (Ubuntu, Raspberry Pi OS...)_ +_These instructions assume a Debian-based Linux distribution (Ubuntu, Raspberry Pi OS, Mint, ...)_ 1. **Switch to user `root`**: - `sudo -i` -2. **Install git, imagemagick, netifaces, pip, venv, and cryptography:** +2. **Install git, imagemagick, netifaces, pip, and venv:** - - `apt install git imagemagick python3-netifaces python3-pip python3-venv python3-cryptography` - - **PRO TIPS**: - - On **Ubuntu** and **Debian**, `python3-cryptography` is installed by default, unlike on **Raspberry Pi OS**. - - Installing `python3-cryptography` (above) is not actually required — but can help if you're having trouble pip installing `cryptography` in Step 6. (If so, run `python3 -m venv venv --system-site-packages` instead of Step 5., to give the virtual environment access your OS's python3-cryptography, allowing you to skip Step 6.) + - `apt install git imagemagick python3-netifaces python3-pip python3-venv` 3. **Download and extract Calibre-Web:** - `cd /opt` @@ -26,18 +22,26 @@ _These instructions assume a Debian-based Linux distribution (Ubuntu, Raspberry 5. **Install dependencies:** - `./venv/bin/python3 -m pip install -r requirements.txt` + **PRO TIPS**: + + - If the above has trouble pip installing `cryptography`, start over (from the beginning!) and **instead of Step 4.** run `apt install python3-cryptography` then `python3 -m venv venv --system-site-packages` — to give the virtual environment access your OS's python3-cryptography. + + - Just FYI on **Ubuntu** and **Debian**, `python3-cryptography` is already installed by default, unlike on **Raspberry Pi OS**. + + -7. **Run Calibre-Web:** _(FYI the command below does NOT come back to the prompt, and that's OK!)_ +6. **Run Calibre-Web:** _(FYI the command below does NOT come back to the prompt, and that's OK!)_ - `./venv/bin/python3 cps.py` **PRO TIP:** - - Or use `nohup ./venv/bin/python3 cps.py` if you want to exit the terminal window. + - Or use `nohup ./venv/bin/python3 cps.py` if you want it to come back to the prompt, allowing you to exit the terminal window, as Calibre-Web continues running in the background. -8. **[Browse to try it out!](https://github.com/janeczku/calibre-web#quick-start)** +7. **[Browse to try it out!](https://github.com/janeczku/calibre-web#quick-start)**