Installare WebODM e ODM su Ubuntu con Docker Engine

Perché Linux è la piattaforma di riferimento#

Su Linux Docker gira in modo nativo, senza la macchina virtuale che Docker Desktop richiede su Windows e macOS. Tutta la RAM e tutti i core del computer sono disponibili per il motore, non c'è un disco virtuale da 20 GB da allargare, e l'accelerazione GPU NVIDIA funziona direttamente. È il motivo per cui le workstation di studio e i server usano quasi sempre questa strada, ed è la stessa procedura che seguirai su un server in cloud, descritta nella guida server cloud o VPS.

Cosa installi dipende dalla linea. Le due linee, nate dalla separazione del 6 aprile 2026, hanno strade diverse su Linux.

Il termine "Docker Engine" indica il servizio Docker da riga di comando, senza interfaccia grafica: è ciò che si installa su Linux. "Docker Desktop" è l'applicazione per Windows e Mac. Entrambi eseguono contenitori (container), cioè programmi impacchettati con tutte le loro dipendenze. I termini sono nel glossario.

Installazione#

Passo 1: aggiorna il sistema e installa Docker Engine#

Vale per entrambe le linee. Apri un terminale e aggiorna i pacchetti.

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

Installa poi Docker Engine seguendo la procedura ufficiale di Docker per Ubuntu, che aggiunge il repository di Docker e installa il motore insieme al plugin Docker Compose. Non riportiamo qui i comandi perché Docker li aggiorna di tanto in tanto e la pagina ufficiale è sempre corretta per la tua versione di Ubuntu. Evita il pacchetto docker.io dei repository di Ubuntu, spesso datato, e i pacchetti Snap: WebODM si aspetta la versione distribuita da Docker, e la stessa scelta è la più sicura anche per le immagini della linea ODM.

Al termine, docker --version deve rispondere con il numero di versione.

Passo 2: aggiungi il tuo utente al gruppo docker#

Vale per entrambe le linee. Per impostazione predefinita solo root può parlare con Docker, e sia lo script di WebODM sia un docker run fallirebbero con un errore di permessi. La documentazione di WebODM indica la soluzione: aggiungere il tuo utente al gruppo docker, poi uscire e rientrare nella sessione perché il cambiamento abbia effetto.

sudo usermod -aG docker $USER
# uscire e rientrare nella shell
./webodm.sh start

L'ultima riga riguarda la linea WebODM e la eseguirai dopo il clone del passo 4; la riportiamo perché così compare nella documentazione. Dopo il nuovo accesso, docker ps senza sudo deve rispondere con un elenco, anche vuoto, e non con un errore di permessi. La pagina Docker sui passi post-installazione spiega le implicazioni di sicurezza di questa scelta: chi è nel gruppo docker ha, di fatto, privilegi equivalenti a root sulla macchina.

Passo 3: installa Git#

Serve alla linea WebODM per clonare il repository; per la linea ODM via immagini Docker non è necessario, ma non fa danni.

sudo apt-get install git

Passo 4: scarica e avvia la tua linea#

Da qui le due linee divergono. Segui il blocco della tua linea; dal passo 5 in avanti il testo indica cosa vale per ciascuna.

WebODM / ODXOpenDroneMap / ODM

WebODM / ODX

Spostati nella cartella in cui vuoi tenere l'installazione, per esempio la tua home, ed esegui i tre comandi, uno alla volta.

bash

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

L'opzione --config core.autocrlf=input è pensata per Windows e su Linux non cambia nulla, ma tenerla rende il comando identico su ogni sistema. --depth 1 scarica solo l'ultima versione senza la cronologia.

Il primo ./webodm.sh start scarica le immagini Docker con prefisso webodm/, diversi gigabyte, e avvia i contenitori: database PostgreSQL, coda dei messaggi, applicazione web e nodo di elaborazione NodeODX. Vedrai scorrere i log per alcuni minuti. L'avvio è completo quando compaiono le righe che indicano l'applicazione in ascolto.

OpenDroneMap / ODM

Per il motore ODM da riga di comando, crea una cartella di progetto con le foto nella sottocartella images (per esempio /home/utente/datasets/progetto/images) ed esegui:

bash

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

Il pull scarica l'immagine (diversi gigabyte). Il run elabora le foto e scrive gli output nelle sottocartelle del progetto, poi termina; con --rm il contenitore viene rimosso, i dati restano nella cartella montata. Le opzioni di elaborazione si aggiungono in coda: la guida ODM da riga di comando spiega la sintassi. La documentazione ODM descrive anche un'installazione nativa su Ubuntu 24.04 con bash configure.sh install dal repository github.com/OpenDroneMap/ODM: è una strada per chi sviluppa o non vuole Docker, da verificare su docs.opendronemap.org.

Per un nodo di elaborazione sempre attivo, con interfaccia web minima e API REST, avvia NodeODM:

bash

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

La porta 3000 è quella storica di NodeODM e --restart unless-stopped fa ripartire il contenitore al boot insieme a Docker: verifica nel README dell'immagine su Docker Hub e su docs.opendronemap.org porta, opzioni di avvio (per esempio il numero massimo di lavori paralleli e la cartella dei dati) e sintassi aggiornata prima di affidarti a questi comandi.

Passo 5: apri l'interfaccia#

WebODM / ODXOpenDroneMap / ODM

WebODM / ODX

Dal browser della stessa macchina apri http://localhost:8000. Da un altro computer della rete locale usa l'indirizzo IP della macchina Ubuntu, per esempio http://192.168.1.50:8000, purché il firewall lo consenta. Crea l'utente amministratore e verifica nel menu dei nodi di elaborazione che il nodo locale sia online.

OpenDroneMap / ODM

Con ODM da riga di comando non c'è un'interfaccia: gli output sono nella cartella del progetto, pronti per QGIS. Con NodeODM apri http://localhost:3000 (o l'IP della macchina seguito dalla porta pubblicata, dalla rete locale): l'interfaccia web minima permette di caricare immagini, avviare un lavoro e scaricare gli output, senza utenti né progetti. Non c'è un account da creare: chi raggiunge la porta può usare il nodo, quindi non esporla oltre la rete locale senza le cautele descritte nella guida su NodeODM e ClusterODM.

Interfaccia WebODM con nodo NodeODM della nonprofit#

Alcuni lettori vogliono l'interfaccia completa di WebODM e, come nodo di calcolo, il NodeODM della nonprofit con il motore ODM, per esempio per confrontare i due motori dallo stesso pannello. Tecnicamente è possibile: avvii WebODM come nel blocco della linea WebODM, avvii NodeODM come nel blocco della linea ODM su una porta diversa da quelle usate da WebODM, e aggiungi il nodo dal menu Processing Nodes di WebODM indicando indirizzo e porta.

Archivio progetti su un disco dedicato#

È la configurazione adatta a chi lavora sul serio, e va decisa subito. Il principio vale per entrambe le linee: i dati vanno su un disco capiente, i file temporanei su un disco veloce. Il modo di ottenerlo è diverso.

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

Una scelta sensata, per entrambe, è un SSD per sistema e file temporanei, e un disco capiente, anche meccanico, per l'archivio.

Avvio automatico al riavvio#

Dopo un riavvio della macchina vuoi che tutto torni disponibile senza intervento. Il servizio Docker Engine si avvia da solo al boot se è abilitato in systemd, cosa che l'installazione ufficiale fa per impostazione predefinita; puoi verificarlo con systemctl is-enabled docker. I contenitori, a loro volta, ripartono con Docker solo se hanno una restart policy (per esempio unless-stopped o always).

[Unit]
Description=WebODM
After=docker.service
Requires=docker.service

[Service]
Type=oneshot
RemainAfterExit=yes
User=utente
WorkingDirectory=/home/utente/WebODM
ExecStart=/home/utente/WebODM/webodm.sh start --media-dir /storage/media --node-dir /storage/node
ExecStop=/home/utente/WebODM/webodm.sh stop

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now webodm.service

Gestire l'installazione#

./webodm.sh stop
./webodm.sh update
./webodm.sh start && ./webodm.sh resetadminpassword nuovapassword
./webodm.sh down

git remote set-url origin https://github.com/WebODM/WebODM.git
./webodm.sh update

Problemi frequenti#

"permission denied" parlando con Docker. L'utente non è nel gruppo docker, o non sei ancora uscito e rientrato dopo usermod. Ripeti il passo 2. Vale per entrambe le linee.

"Out of memory" durante l'elaborazione. Su Linux non c'è un limite di Docker Desktop da alzare: la RAM è quella fisica. Riduci il dataset, ridimensiona le immagini o abbassa la qualità, come nella guida su tempi e memoria, oppure aumenta la RAM. Vale per ODX e per ODM.

"No space left on device". Il disco di sistema è pieno di immagini Docker e progetti. Sposta l'archivio su un disco dedicato (--media-dir per WebODM, cartella montata per la linea ODM) e rimuovi i progetti di prova.

Porta 8000 o 3000 occupata o non raggiungibile dalla rete. Verifica con ss -ltnp chi usa la porta e controlla le regole del firewall (ufw). La guida agli errori comuni tratta entrambi i casi. Per NodeODM puoi cambiare il primo numero in -p.

ODM da riga di comando non trova le immagini. Le foto non sono nella sottocartella images del progetto, oppure il percorso passato a -v è sbagliato. Controlla con ls prima di lanciare il contenitore.

Dopo il riavvio WebODM non parte. Controlla systemctl status docker e, se hai creato il servizio, systemctl status webodm e il relativo journal. Per NodeODM, controlla che il contenitore abbia la restart policy con docker inspect.

Prossimi passi#

• Elabora il primo dataset: Il primo progetto passo passo.
• Confronta i comandi delle due linee su tutte le piattaforme: Installazione a confronto.
• Esponi l'installazione in sicurezza su internet: Server cloud o VPS.
• Tieni al sicuro i dati: Aggiornare, fare backup e ripristinare.