Compare commits
1 Commits
bb697750b7
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
| 5f41744d93 |
@@ -38,6 +38,8 @@ The ecosystem consists of three main parts:
|
|||||||
* Run: `python3 app.py`
|
* Run: `python3 app.py`
|
||||||
|
|
||||||
#### 🔑 Generating VAPID Keys (Push Notifications)
|
#### 🔑 Generating VAPID Keys (Push Notifications)
|
||||||
|
> ⚠️ **IMPORTANT:** Web Push Notifications strictly require the dashboard to be accessed via a secure **HTTPS** connection (or localhost). Modern browsers will block push features over standard HTTP.
|
||||||
|
|
||||||
To enable Web Push Notifications, you must generate a unique VAPID key pair for your server.
|
To enable Web Push Notifications, you must generate a unique VAPID key pair for your server.
|
||||||
1. Go to a free online generator like [vapidkeys.com](https://vapidkeys.com/).
|
1. Go to a free online generator like [vapidkeys.com](https://vapidkeys.com/).
|
||||||
2. Generate the keys.
|
2. Generate the keys.
|
||||||
@@ -100,6 +102,8 @@ L'ecosistema si compone di tre parti principali:
|
|||||||
* Avvia: `python3 app.py`
|
* Avvia: `python3 app.py`
|
||||||
|
|
||||||
#### 🔑 Generare le chiavi VAPID (Notifiche Push)
|
#### 🔑 Generare le chiavi VAPID (Notifiche Push)
|
||||||
|
> ⚠️ **IMPORTANTE:** Le Notifiche Push Web richiedono tassativamente che la dashboard sia accessibile tramite una connessione sicura **HTTPS** (o localhost). I browser mobili e desktop bloccano le notifiche su connessioni HTTP non protette.
|
||||||
|
|
||||||
Per abilitare le Notifiche Push, devi generare una coppia di chiavi VAPID univoca per il tuo server.
|
Per abilitare le Notifiche Push, devi generare una coppia di chiavi VAPID univoca per il tuo server.
|
||||||
1. Vai su un generatore online gratuito come [vapidkeys.com](https://vapidkeys.com/).
|
1. Vai su un generatore online gratuito come [vapidkeys.com](https://vapidkeys.com/).
|
||||||
2. Genera la coppia di chiavi.
|
2. Genera la coppia di chiavi.
|
||||||
|
|||||||
+8
-10
@@ -4,14 +4,12 @@
|
|||||||
|
|
||||||
This guide describes the steps to install the Central
|
This guide describes the steps to install the Central
|
||||||
Dashboard and the Remote Agents on MMDVM nodes.
|
Dashboard and the Remote Agents on MMDVM nodes.
|
||||||
|
|
||||||
------------------------------------------------------------
|
------------------------------------------------------------
|
||||||
1. PRE-REQUISITES
|
1. PRE-REQUISITES
|
||||||
------------------------------------------------------------
|
------------------------------------------------------------
|
||||||
Ensure Python 3 is installed on all systems.
|
Ensure Python 3 is installed on all systems.
|
||||||
The necessary dependencies are listed in the
|
The necessary dependencies are listed in the
|
||||||
'requirements.txt' file.
|
'requirements.txt' file.
|
||||||
|
|
||||||
Install dependencies:
|
Install dependencies:
|
||||||
pip install -r requirements.txt
|
pip install -r requirements.txt
|
||||||
|
|
||||||
@@ -19,7 +17,6 @@ Install dependencies:
|
|||||||
2. SERVER SETUP (CENTRAL HUB)
|
2. SERVER SETUP (CENTRAL HUB)
|
||||||
------------------------------------------------------------
|
------------------------------------------------------------
|
||||||
The server handles the web interface and user permissions.
|
The server handles the web interface and user permissions.
|
||||||
|
|
||||||
Steps:
|
Steps:
|
||||||
1. Configure 'config.json' using 'config.example.json' as a template.
|
1. Configure 'config.json' using 'config.example.json' as a template.
|
||||||
2. Enter MQTT credentials and VAPID keys.
|
2. Enter MQTT credentials and VAPID keys.
|
||||||
@@ -32,6 +29,10 @@ Steps:
|
|||||||
------------------------------------------------------------
|
------------------------------------------------------------
|
||||||
Required to enable browser and mobile notifications.
|
Required to enable browser and mobile notifications.
|
||||||
|
|
||||||
|
⚠️ WARNING: Web Push Notifications strictly require the
|
||||||
|
dashboard to be accessed via a secure HTTPS connection
|
||||||
|
(or localhost). They will NOT work over standard HTTP.
|
||||||
|
|
||||||
1. Go to https://vapidkeys.com/ and generate the keys.
|
1. Go to https://vapidkeys.com/ and generate the keys.
|
||||||
2. Copy 'Public Key' and 'Private Key' into 'config.json'.
|
2. Copy 'Public Key' and 'Private Key' into 'config.json'.
|
||||||
3. Set 'vapid_claim_email' (e.g., "mailto:your@email.com").
|
3. Set 'vapid_claim_email' (e.g., "mailto:your@email.com").
|
||||||
@@ -40,7 +41,6 @@ Required to enable browser and mobile notifications.
|
|||||||
4. AGENT SETUP (REMOTE NODES)
|
4. AGENT SETUP (REMOTE NODES)
|
||||||
------------------------------------------------------------
|
------------------------------------------------------------
|
||||||
To be installed on each Raspberry Pi / MMDVM Node.
|
To be installed on each Raspberry Pi / MMDVM Node.
|
||||||
|
|
||||||
1. Copy 'system_monitor.py' and 'node_config.json' to
|
1. Copy 'system_monitor.py' and 'node_config.json' to
|
||||||
'/opt/node_agent/'.
|
'/opt/node_agent/'.
|
||||||
2. Edit 'node_config.json' with a unique 'client_id'.
|
2. Edit 'node_config.json' with a unique 'client_id'.
|
||||||
@@ -50,7 +50,6 @@ To be installed on each Raspberry Pi / MMDVM Node.
|
|||||||
5. RUNNING AS A SERVICE (SYSTEMD)
|
5. RUNNING AS A SERVICE (SYSTEMD)
|
||||||
------------------------------------------------------------
|
------------------------------------------------------------
|
||||||
For auto-start and process monitoring.
|
For auto-start and process monitoring.
|
||||||
|
|
||||||
Configuration:
|
Configuration:
|
||||||
1. Copy .service files to '/etc/systemd/system/':
|
1. Copy .service files to '/etc/systemd/system/':
|
||||||
- Server: sudo cp fleet-console.service /etc/systemd/system/
|
- Server: sudo cp fleet-console.service /etc/systemd/system/
|
||||||
@@ -69,14 +68,12 @@ Configuration:
|
|||||||
|
|
||||||
Questa guida descrive i passaggi per installare la Dashboard
|
Questa guida descrive i passaggi per installare la Dashboard
|
||||||
Centrale e gli Agenti Remoti sui nodi MMDVM.
|
Centrale e gli Agenti Remoti sui nodi MMDVM.
|
||||||
|
|
||||||
------------------------------------------------------------
|
------------------------------------------------------------
|
||||||
1. REQUISITI PRELIMINARI
|
1. REQUISITI PRELIMINARI
|
||||||
------------------------------------------------------------
|
------------------------------------------------------------
|
||||||
Assicurarsi di avere Python 3 installato su tutti i sistemi.
|
Assicurarsi di avere Python 3 installato su tutti i sistemi.
|
||||||
Le dipendenze necessarie sono elencate nel file
|
Le dipendenze necessarie sono elencate nel file
|
||||||
'requirements.txt'.
|
'requirements.txt'.
|
||||||
|
|
||||||
Installazione dipendenze:
|
Installazione dipendenze:
|
||||||
pip install -r requirements.txt
|
pip install -r requirements.txt
|
||||||
|
|
||||||
@@ -84,7 +81,6 @@ Installazione dipendenze:
|
|||||||
2. SETUP DEL SERVER (HUB CENTRALE)
|
2. SETUP DEL SERVER (HUB CENTRALE)
|
||||||
------------------------------------------------------------
|
------------------------------------------------------------
|
||||||
Il server gestisce l'interfaccia web e i permessi.
|
Il server gestisce l'interfaccia web e i permessi.
|
||||||
|
|
||||||
Passaggi:
|
Passaggi:
|
||||||
1. Configura 'config.json' partendo da 'config.example.json'.
|
1. Configura 'config.json' partendo da 'config.example.json'.
|
||||||
2. Inserisci le credenziali MQTT e le chiavi VAPID.
|
2. Inserisci le credenziali MQTT e le chiavi VAPID.
|
||||||
@@ -97,6 +93,10 @@ Passaggi:
|
|||||||
------------------------------------------------------------
|
------------------------------------------------------------
|
||||||
Necessarie per abilitare le notifiche su browser e mobile.
|
Necessarie per abilitare le notifiche su browser e mobile.
|
||||||
|
|
||||||
|
⚠️ ATTENZIONE: Le notifiche push richiedono tassativamente
|
||||||
|
che la dashboard sia accessibile tramite una connessione
|
||||||
|
sicura HTTPS. I browser bloccano la funzione su HTTP normale.
|
||||||
|
|
||||||
1. Vai su https://vapidkeys.com/ e genera le chiavi.
|
1. Vai su https://vapidkeys.com/ e genera le chiavi.
|
||||||
2. Copia 'Public Key' e 'Private Key' nel 'config.json'.
|
2. Copia 'Public Key' e 'Private Key' nel 'config.json'.
|
||||||
3. Imposta 'vapid_claim_email' (es. "mailto:tua@email.com").
|
3. Imposta 'vapid_claim_email' (es. "mailto:tua@email.com").
|
||||||
@@ -105,7 +105,6 @@ Necessarie per abilitare le notifiche su browser e mobile.
|
|||||||
4. SETUP DELL'AGENTE (NODI REMOTI)
|
4. SETUP DELL'AGENTE (NODI REMOTI)
|
||||||
------------------------------------------------------------
|
------------------------------------------------------------
|
||||||
Da installare su ogni Raspberry Pi / Nodo MMDVM.
|
Da installare su ogni Raspberry Pi / Nodo MMDVM.
|
||||||
|
|
||||||
1. Copia 'system_monitor.py' e 'node_config.json' in
|
1. Copia 'system_monitor.py' e 'node_config.json' in
|
||||||
'/opt/node_agent/'.
|
'/opt/node_agent/'.
|
||||||
2. Modifica 'node_config.json' con il 'client_id' univoco.
|
2. Modifica 'node_config.json' con il 'client_id' univoco.
|
||||||
@@ -115,7 +114,6 @@ Da installare su ogni Raspberry Pi / Nodo MMDVM.
|
|||||||
5. ESECUZIONE COME SERVIZIO (SYSTEMD)
|
5. ESECUZIONE COME SERVIZIO (SYSTEMD)
|
||||||
------------------------------------------------------------
|
------------------------------------------------------------
|
||||||
Per l'avvio automatico e il monitoraggio del processo.
|
Per l'avvio automatico e il monitoraggio del processo.
|
||||||
|
|
||||||
Configurazione:
|
Configurazione:
|
||||||
1. Copia i file .service in '/etc/systemd/system/':
|
1. Copia i file .service in '/etc/systemd/system/':
|
||||||
- Server: sudo cp fleet-console.service /etc/systemd/system/
|
- Server: sudo cp fleet-console.service /etc/systemd/system/
|
||||||
|
|||||||
Reference in New Issue
Block a user