diff --git a/README.md b/README.md index eeea965..2a17edd 100644 --- a/README.md +++ b/README.md @@ -38,6 +38,8 @@ The ecosystem consists of three main parts: * Run: `python3 app.py` #### 🔑 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. 1. Go to a free online generator like [vapidkeys.com](https://vapidkeys.com/). 2. Generate the keys. @@ -100,6 +102,8 @@ L'ecosistema si compone di tre parti principali: * Avvia: `python3 app.py` #### 🔑 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. 1. Vai su un generatore online gratuito come [vapidkeys.com](https://vapidkeys.com/). 2. Genera la coppia di chiavi. diff --git a/install.txt b/install.txt index 225787a..e269b2a 100644 --- a/install.txt +++ b/install.txt @@ -4,14 +4,12 @@ This guide describes the steps to install the Central Dashboard and the Remote Agents on MMDVM nodes. - ------------------------------------------------------------ 1. PRE-REQUISITES ------------------------------------------------------------ Ensure Python 3 is installed on all systems. The necessary dependencies are listed in the 'requirements.txt' file. - Install dependencies: pip install -r requirements.txt @@ -19,7 +17,6 @@ Install dependencies: 2. SERVER SETUP (CENTRAL HUB) ------------------------------------------------------------ The server handles the web interface and user permissions. - Steps: 1. Configure 'config.json' using 'config.example.json' as a template. 2. Enter MQTT credentials and VAPID keys. @@ -32,6 +29,10 @@ Steps: ------------------------------------------------------------ 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. 2. Copy 'Public Key' and 'Private Key' into 'config.json'. 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) ------------------------------------------------------------ To be installed on each Raspberry Pi / MMDVM Node. - 1. Copy 'system_monitor.py' and 'node_config.json' to '/opt/node_agent/'. 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) ------------------------------------------------------------ For auto-start and process monitoring. - Configuration: 1. Copy .service files to '/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 Centrale e gli Agenti Remoti sui nodi MMDVM. - ------------------------------------------------------------ 1. REQUISITI PRELIMINARI ------------------------------------------------------------ Assicurarsi di avere Python 3 installato su tutti i sistemi. Le dipendenze necessarie sono elencate nel file 'requirements.txt'. - Installazione dipendenze: pip install -r requirements.txt @@ -84,7 +81,6 @@ Installazione dipendenze: 2. SETUP DEL SERVER (HUB CENTRALE) ------------------------------------------------------------ Il server gestisce l'interfaccia web e i permessi. - Passaggi: 1. Configura 'config.json' partendo da 'config.example.json'. 2. Inserisci le credenziali MQTT e le chiavi VAPID. @@ -97,6 +93,10 @@ Passaggi: ------------------------------------------------------------ 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. 2. Copia 'Public Key' e 'Private Key' nel 'config.json'. 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) ------------------------------------------------------------ Da installare su ogni Raspberry Pi / Nodo MMDVM. - 1. Copia 'system_monitor.py' e 'node_config.json' in '/opt/node_agent/'. 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) ------------------------------------------------------------ Per l'avvio automatico e il monitoraggio del processo. - Configurazione: 1. Copia i file .service in '/etc/systemd/system/': - Server: sudo cp fleet-console.service /etc/systemd/system/