From 34647ddc33b8c742d557ecf9edb9db27eecf797a Mon Sep 17 00:00:00 2001
From: Roby <roberto@iv3jdv.net>
Date: Mon, 27 Apr 2026 16:38:55 +0200
Subject: [PATCH] update readme

---
 README.md   | 30 ++++++++++++++++++++----------
 install.txt | 30 ++++++++++++++++++++++--------
 2 files changed, 42 insertions(+), 18 deletions(-)

diff --git a/README.md b/README.md
index 9e4c462..5e8822d 100644
--- a/README.md
+++ b/README.md
@@ -29,6 +29,11 @@ To enable full functionality, you must configure these three files:
 
 ### 🚀 Installation Guide
 
+#### 0. Root Privileges
+All installation steps must be executed as the `root` user. Before starting, elevate your privileges by running:
+```bash
+sudo su
+
 #### 1. Clone the Repository
 Clone the agent into `/opt` to ensure path consistency:
 ```bash
@@ -40,7 +45,7 @@ cd /opt/fleet-node-agent
 ```bash
 sudo python3 -m venv venv
 source venv/bin/activate
-sudo pip install -r requirements.txt
+pip install -r requirements.txt
 ```
 
 #### 3. Configuration
@@ -52,10 +57,10 @@ sudo pip install -r requirements.txt
 
 #### 4. Systemd Service (Auto-start)
 ```bash
-sudo cp fleet-agent.service /etc/systemd/system/
-sudo systemctl daemon-reload
-sudo systemctl enable fleet-agent
-sudo systemctl start fleet-agent
+cp fleet-agent.service /etc/systemd/system/
+systemctl daemon-reload
+systemctl enable fleet-agent
+systemctl start fleet-agent
 ```
 
 ---
@@ -85,6 +90,11 @@ Per il corretto funzionamento, è necessario definire i parametri in questi tre
 
 ### 🚀 Guida all'Installazione
 
+#### 0. Privilegi di Root
+Tutti i passaggi di installazione devono essere eseguiti come utente `root`. Prima di iniziare, eleva i tuoi privilegi eseguendo:
+```bash
+sudo su
+
 #### 1. Clonazione del Repository
 Clona l'agente nella cartella `/opt` per garantire la coerenza con i servizi systemd:
 ```bash
@@ -96,7 +106,7 @@ cd /opt/fleet-node-agent
 ```bash
 sudo python3 -m venv venv
 source venv/bin/activate
-sudo pip install -r requirements.txt
+pip install -r requirements.txt
 ```
 
 #### 3. Personalizzazione
@@ -108,10 +118,10 @@ sudo pip install -r requirements.txt
 
 #### 4. Esecuzione come Servizio (systemd)
 ```bash
-sudo cp fleet-agent.service /etc/systemd/system/
-sudo systemctl daemon-reload
-sudo systemctl enable fleet-agent
-sudo systemctl start fleet-agent
+cp fleet-agent.service /etc/systemd/system/
+systemctl daemon-reload
+systemctl enable fleet-agent
+systemctl start fleet-agent
 ```
 
 ---
diff --git a/install.txt b/install.txt
index 53d8e3f..60e9363 100644
--- a/install.txt
+++ b/install.txt
@@ -5,6 +5,13 @@
 This script is meant to be installed on each remote node
 (e.g., Raspberry Pi, MMDVM host). [cite: 11]
 
+------------------------------------------------------------
+0. IMPORTANT: ROOT PRIVILEGES
+------------------------------------------------------------
+All installation steps must be executed as the "root" user.
+Before starting, elevate your privileges by running:
+   sudo su
+
 ------------------------------------------------------------
 1. PRE-REQUISITES & INSTALLATION
 ------------------------------------------------------------
@@ -42,10 +49,10 @@ D) OPTIONAL:
 ------------------------------------------------------------
 3. RUNNING AS A SERVICE (SYSTEMD)
 ------------------------------------------------------------
-1. sudo cp fleet-agent.service /etc/systemd/system/
-2. sudo systemctl daemon-reload
-3. sudo systemctl enable fleet-agent
-4. sudo systemctl start fleet-agent
+1. cp fleet-agent.service /etc/systemd/system/
+2. systemctl daemon-reload
+3. systemctl enable fleet-agent
+4. systemctl start fleet-agent
 
 
 ============================================================
@@ -55,6 +62,13 @@ D) OPTIONAL:
 Questo script va installato su ogni nodo remoto 
 (es. Raspberry Pi, MMDVM host). [cite: 11]
 
+------------------------------------------------------------
+0. IMPORTANTE: PRIVILEGI DI ROOT
+------------------------------------------------------------
+Tutti i passaggi di installazione devono essere eseguiti 
+come utente "root". Prima di iniziare, eleva i tuoi privilegi:
+   sudo su
+
 ------------------------------------------------------------
 1. REQUISITI E INSTALLAZIONE
 ------------------------------------------------------------
@@ -92,8 +106,8 @@ D) OPZIONALE:
 ------------------------------------------------------------
 3. ESECUZIONE COME SERVIZIO (SYSTEMD)
 ------------------------------------------------------------
-1. sudo cp fleet-agent.service /etc/systemd/system/
-2. sudo systemctl daemon-reload
-3. sudo systemctl enable fleet-agent
-4. sudo systemctl start fleet-agent
+1. cp fleet-agent.service /etc/systemd/system/
+2. systemctl daemon-reload
+3. systemctl enable fleet-agent
+4. systemctl start fleet-agent
 ============================================================