Installare WebODM o NodeODM su un server cloud o VPS

Un server cloud è la strada giusta quando il computer in ufficio non basta, quando più persone devono usare la stessa installazione o quando vuoi che i dati restino su una macchina che controlli tu, senza affidarli a un servizio esterno. In questa guida prepari un VPS (Virtual Private Server) con Ubuntu e Docker, poi installi la tua linea. Alla fine trovi le considerazioni sui costi e le regole minime di sicurezza.

Cosa installi dipende dalla linea, e su un server la differenza è più marcata che sul PC.

Scegliere il server#

Vale per entrambe le linee.

Quanta RAM#

La fotogrammetria è affamata di memoria. La documentazione di WebODM indica questa scala: circa 4 GB per 40 immagini, 16 GB per 250, 32 GB per 500, 64 GB per 1.500 e 256 GB per 5.000. La sola interfaccia, senza nodo di elaborazione, si accontenta di 1–2 GB. La documentazione di ODM indica 4 GB come minimo per 100–200 immagini e 16 GB consigliati: gli ordini di grandezza coincidono.

Per un uso professionale tipico (rilievi da 200 a 600 immagini) un'istanza con 32 GB di RAM è un buon punto di partenza. Il disco conta quasi quanto la RAM: entrambe le documentazioni consigliano 100 GB liberi, e ogni progetto conserva immagini originali e tutti i risultati. Trovi la tabella completa nella guida Requisiti hardware.

Quale provider#

Entrambe le linee funzionano su qualsiasi VPS che esegua Ubuntu LTS e Docker: Hetzner, AWS, OVH, Aruba e molti altri offrono istanze adatte. Le differenze riguardano il prezzo orario, la sede dei data center (per una PA italiana può contare che i dati restino nell'Unione Europea) e la possibilità di accendere e spegnere la macchina a piacere. Per la scelta della distribuzione tra installer, Docker, server e servizi cloud vedi Quale versione scegliere; i comandi delle due linee affiancati sono in Installazione a confronto.

Costi: ordini di grandezza#

Non riportiamo cifre puntuali perché i listini cambiano spesso. L'ordine di grandezza è questo: un'istanza con 32 GB di RAM costa pochi euro al giorno se resta accesa solo durante l'elaborazione, e alcune decine di euro al mese se resta sempre accesa. Il disco si paga a parte, in base ai GB allocati, anche a macchina spenta. Prima di decidere, controlla il listino del provider e verifica se la fatturazione è oraria o mensile.

Una strategia comune è tenere una macchina piccola sempre accesa per l'interfaccia e accenderne una grande solo quando serve elaborare: è il modello a nodi descritto nella guida NodeODX, NodeODM e nodi di elaborazione, e vale per entrambe le linee.

Installazione#

1. Creare l'istanza e collegarsi via SSH#

Vale per entrambe le linee. Crea un'istanza con Ubuntu LTS (22.04 o 24.04) e, dove possibile, una chiave SSH al posto della password. Collegati con il tuo client SSH abituale e aggiorna il sistema. Il comando seguente aggiorna gli elenchi dei pacchetti e installa gli aggiornamenti disponibili.

sudo apt-get update && sudo apt-get upgrade

Attendi la fine dell'operazione; se il kernel viene aggiornato, riavvia la macchina.

2. Installare Docker#

Vale per entrambe le linee. Installa Docker Engine e il plugin docker compose seguendo la procedura ufficiale per Ubuntu. Al termine aggiungi il tuo utente al gruppo docker, così non dovrai usare sudo per ogni comando.

sudo usermod -aG docker $USER
# uscire e rientrare nella shell

Esci dalla sessione SSH e rientra: il nuovo gruppo diventa effettivo solo a un nuovo login.

3. Scaricare e avviare la tua linea#

Da qui le due linee divergono. Segui il blocco della tua linea.

git clone https://github.com/WebODM/WebODM --config core.autocrlf=input --depth 1
cd WebODM
./webodm.sh start

./webodm.sh restart --media-dir /storage/media --node-dir /storage/node

docker pull opendronemap/nodeodm
docker run -d -p 3000:3000 --restart unless-stopped opendronemap/nodeodm

docker pull opendronemap/odm
docker run -ti --rm -v /storage/datasets:/datasets opendronemap/odm --project-path /datasets progetto

4. Aprire la porta nel firewall#

Ogni provider ha il proprio firewall (security group su AWS, firewall del progetto su Hetzner, regole di rete su OVH e Aruba). Se sul server è attivo anche un firewall locale come ufw, apri la stessa porta anche lì.

WebODM / ODXOpenDroneMap / ODM

WebODM / ODX

Aggiungi una regola in ingresso per TCP 8000. Poi apri il browser all'indirizzo http://IP-DEL-SERVER:8000: al primo accesso WebODM ti chiede di creare l'utente amministratore.

OpenDroneMap / ODM

Aggiungi una regola in ingresso per la porta del nodo (TCP 3000 con il comando sopra). Poi apri http://IP-DEL-SERVER:3000: compare l'interfaccia web minima di NodeODM, senza login. Attenzione: chiunque raggiunga la porta può inviare lavori e scaricare risultati. Prima di lasciarla aperta su internet, limita la regola del firewall agli indirizzi IP che devono usare il nodo (il tuo ufficio, la macchina dell'interfaccia) e verifica su docs.opendronemap.org e nel README dell'immagine le opzioni di autenticazione del nodo.

5. Attivare HTTPS con un nome di dominio#

Un servizio esposto in chiaro su Internet non è accettabile per un uso professionale: password e dati viaggiano senza cifratura. Ti serve un nome di dominio (o sottodominio) con un record DNS che punti all'IP pubblico del server.

./webodm.sh restart --ssl --hostname webodm.miaazienda.it   # Let's Encrypt

Interfaccia WebODM con nodo ODM sul server#

Una configurazione che alcuni lettori cercano è WebODM (sul PC o su un secondo server piccolo) come interfaccia, e il server grande con NodeODM della nonprofit come nodo di calcolo. Si aggiunge il nodo dal menu Processing Nodes di WebODM indicando indirizzo e porta del server.

Utenti multipli#

./webodm.sh start && ./webodm.sh resetadminpassword nuovapassword

Sicurezza di base#

Vale per entrambe le linee. Un server esposto su Internet riceve tentativi di accesso automatici fin dal primo minuto. Non serve essere esperti di sicurezza, ma serve rispettare alcune regole.

La procedura di backup e ripristino, con i comandi verificati per WebODM, è nella guida Aggiornare, backup e ripristino. Programmala fin dall'inizio: i dati di WebODM vivono nei volumi Docker webodm_dbdata e webodm_appmedia (o nella cartella indicata con --media-dir), non nel repository clonato. Per NodeODM e ODM i dati sono nella cartella o nel volume che hai montato con -v: è quella da copiare altrove.

Problemi frequenti#

La pagina non si apre su IP:8000 (o IP:3000). Nove volte su dieci è il firewall del provider: la regola va aggiunta nel pannello del cloud, non solo sul server. Controlla anche che il contenitore sia effettivamente avviato con docker ps.

Il certificato Let's Encrypt non viene emesso (WebODM). Verifica che il record DNS punti già all'IP del server (la propagazione può richiedere tempo) e che le porte necessarie siano aperte. Rilancia poi il comando --ssl --hostname.

WebODM non vede il nodo NodeODM remoto. Controlla che la porta del nodo sia raggiungibile dalla macchina dell'interfaccia (firewall del provider e ufw) e ricorda l'avvertenza sull'interoperabilità: dopo un aggiornamento di una delle due linee la compatibilità va riverificata.

Out of memory durante l'elaborazione. Il server è troppo piccolo per il dataset. Vale per ODX e ODM. Le soluzioni sono ridimensionare le immagini, ridurre la qualità, oppure passare a un'istanza più grande: vedi Ottimizzare tempi e memoria.

"No space left on device". Il disco del server è pieno. Sposta i dati su un volume dedicato (--media-dir e --node-dir per WebODM, cartella montata con -v per la linea ODM), oppure allarga il disco dal pannello del provider.

Il catalogo completo degli errori, con cause e rimedi, è nella guida Errori comuni.

Prossimi passi#

• Aggiornare, backup e ripristino: metti al sicuro i progetti prima di caricare dati veri.
• NodeODX, NodeODM e nodi di elaborazione: separa interfaccia e calcolo per pagare la macchina grande solo quando serve.
• Installazione a confronto: i comandi delle due linee affiancati per ogni piattaforma.
• Il primo progetto passo passo: carica le prime immagini e ottieni la prima ortofoto.