From b4a6f672fe2e7c23ccef341087f3c77102d257f2 Mon Sep 17 00:00:00 2001
From: Blondel MONDESIR <blondel.md@gmail.com>
Date: Tue, 8 Oct 2024 20:57:03 -0400
Subject: [PATCH] Prepend commands with sudo

---
 Manual-Installation.md | 31 ++++++++++++++++---------------
 1 file changed, 16 insertions(+), 15 deletions(-)

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