Installare WebODM o OpenDroneMap: comandi e download a confronto
In questa pagina
Come leggere questa guida#
Questa guida non sostituisce le guide di installazione passo passo della sezione Installazione. Serve a rispondere in fretta a una domanda: "sulla mia piattaforma, cosa cambia tra le due linee?". Per ogni piattaforma trovi una frase su cosa differisce, poi i due blocchi affiancati, sempre nell'ordine WebODM prima e OpenDroneMap dopo.
Due precisazioni valide ovunque. Primo: i comandi della linea WebODM sono quelli della documentazione di WebODM, verificati il 2 settembre 2026; i comandi della linea OpenDroneMap sono quelli della documentazione di ODM, verificati alla stessa data. Non deduciamo mai un comando di una linea dall'altro. Secondo: dove la documentazione di una linea non descrive una procedura, lo scriviamo e rimandiamo alla pagina ufficiale, invece di inventare.
Il termine ricorrente è Docker: un sistema per eseguire software in ambienti isolati, i container, che portano con sé tutte le dipendenze. Le immagini Docker sono i pacchetti da cui nascono i container. Le definizioni sono nel glossario.
Il quadro d'insieme: quali vie esistono#
Prima dei comandi, la mappa delle vie disponibili. La differenza strutturale tra le due linee è questa: la linea WebODM offre un'interfaccia gratuita su tutte le piattaforme; la linea OpenDroneMap offre il motore ODM gratuito su tutte le piattaforme, un nodo NodeODM gratuito con interfaccia minima e un'interfaccia completa, OpenDroneMap Desktop, a pagamento su Windows. La nonprofit non pubblica, alla data di verifica, un repository open dell'interfaccia: l'indirizzo storico github.com/OpenDroneMap/WebODM reindirizza a github.com/WebODM/WebODM.
| Voce | WebODM / ODX | OpenDroneMap / ODM |
|---|---|---|
| Installer nativo Windows | WebODM 3.2.8, gratuito, Windows 11 (alcune versioni di Windows 10), senza Docker | OpenDroneMap Desktop, a pagamento (64 $ Standard, 149 $ Business alla data), Windows 11 o successivo |
| Installer nativo macOS | WebODM 3.1.4, gratuito, Intel e Apple Silicon (M1–M4) | OpenDroneMap Desktop, installazione via Docker gestito dall'installer |
| Linux | Docker: clone di github.com/WebODM/WebODM e ./webodm.sh start, gratuito |
OpenDroneMap Desktop "gratis con installazione manuale" (opendronemap.org/download; procedura da verificare su docs.opendronemap.org); ODM e NodeODM via Docker, gratuiti |
| Server o VPS | clone e ./webodm.sh start, opzioni --ssl --hostname |
NodeODM (opendronemap/nodeodm) o ODM da CLI; interfaccia completa non disponibile come repository open |
| Motore da riga di comando | immagine webodm/odm (verifica il tag) |
immagine opendronemap/odm; installazione nativa con configure.sh |
| Nodo di elaborazione | webodm/nodeodm (NodeODX) |
opendronemap/nodeodm (NodeODM) |
| Cloud ufficiale | WebODM Lightning (webodm.net), a crediti | nessuno |
| Costo del software | gratuito su tutte le piattaforme | motore e nodo gratuiti; interfaccia a pagamento su Windows, gratuita su Linux con installazione manuale |
| Licenza | AGPL-3.0 | AGPL-3.0 |
| Verificato il | 2 settembre 2026 | 2 settembre 2026 |
Requisiti hardware dichiarati#
Le due documentazioni indicano requisiti simili ma non identici. Li riportiamo entrambi, perché derivano da due pagine diverse.
| Voce | WebODM / ODX (docs.webodm.org) | OpenDroneMap / ODM (docs.opendronemap.org) |
|---|---|---|
| CPU | 64 bit con SSE3/SSSE3 | 64 bit |
| RAM minima | 8 GB (circa 100 immagini) | 4 GB (100–200 immagini) |
| RAM consigliata | 16 GB o più; scala fino a 256 GB per 5.000 immagini | 16 GB |
| Disco | 20 GB minimi, 100 GB consigliati su SSD | 20 GB minimi, 100 GB consigliati |
| GPU | non necessaria; NVIDIA con CUDA accelera l'estrazione feature (Linux/WSL); RTX serie 50 supportate in ODX | non necessaria; la documentazione dichiara che la "GPU currently provides no performance benefit" |
| Verificato il | 2 settembre 2026 | 2 settembre 2026 |
La differenza sulla GPU è una differenza di dichiarazione tra le due documentazioni, non una nostra misura. Approfondimento in GPU NVIDIA.
Windows#
Su Windows la differenza principale è il costo dell'interfaccia: gratuita nella linea WebODM, a pagamento nella linea OpenDroneMap. Entrambi gli installer evitano di far installare Docker a mano.
Scarica l'installer di WebODM 3.2.8 da webodm.org/download. È gratuito, richiede Windows 11 (alcune versioni di Windows 10 sono supportate) e non richiede Docker. Al termine l'interfaccia si apre nel browser.
In alternativa, con Docker Desktop e WSL2 attivi, apri un terminale ed esegui:
git clone https://github.com/WebODM/WebODM --config core.autocrlf=input --depth 1
cd WebODM
./webodm.sh start
L'interfaccia risponde su http://localhost:8000. Su Docker Desktop imposta in Settings → Resources almeno 4 GB di RAM, meglio 16 GB, e aumenta il disco virtuale oltre i 20 GB predefiniti.
OpenDroneMap Desktop si acquista e si scarica da opendronemap.org/download. Alla data di verifica il sito indica due edizioni: Standard (64 $, un anno di supporto) e Business (149 $, supporto prioritario). Requisito: Windows 11 o successivo. Le istruzioni di installazione e i requisiti aggiornati sono su docs.opendronemap.org.
Senza interfaccia completa, il motore ODM è disponibile gratuitamente: con Docker Desktop e WSL2 attivi puoi usare l'immagine opendronemap/odm (sezione "Riga di comando" più sotto), oppure l'installer nativo di ODM per Windows pubblicato tra le release del repository github.com/OpenDroneMap/ODM.
Le procedure complete, con le schermate, sono in Windows con installer e Windows con Docker e WSL2. Per OpenDroneMap Desktop c'è una guida dedicata: OpenDroneMap Desktop.
macOS#
Su macOS entrambe le linee offrono un installer, ma con architetture diverse: quello di WebODM è nativo, quello di OpenDroneMap Desktop usa Docker gestito dall'installer.
Scarica l'installer di WebODM 3.1.4 da webodm.org/download. È gratuito e disponibile per Intel e Apple Silicon (M1–M4).
In alternativa, con Docker Desktop installato:
git clone https://github.com/WebODM/WebODM --config core.autocrlf=input --depth 1
cd WebODM
./webodm.sh start
Interfaccia su http://localhost:8000.
OpenDroneMap Desktop per macOS si scarica da opendronemap.org/download; l'installer gestisce Docker per conto tuo. Condizioni di licenza, requisiti e procedura sono su docs.opendronemap.org: la nostra scheda registra solo la modalità "via Docker gestito".
Il solo motore ODM si installa in modo nativo con Xcode e Homebrew, dal repository ODM:
bash configure_macos.sh install
Oppure via Docker con l'immagine opendronemap/odm (sezione "Riga di comando").
La guida dedicata è macOS.
Linux#
Su Linux la linea WebODM ha una sola via documentata, Docker; la linea OpenDroneMap dichiara un'installazione manuale gratuita di OpenDroneMap Desktop e offre motore e nodo via Docker.
Installa Git e Docker Engine, poi:
git clone https://github.com/WebODM/WebODM --config core.autocrlf=input --depth 1
cd WebODM
./webodm.sh start
Se il tuo utente non è nel gruppo docker:
sudo usermod -aG docker $USER
# uscire e rientrare nella shell
./webodm.sh start
Interfaccia su http://localhost:8000. Per spostare l'archivio dei progetti e i file temporanei su un disco dedicato:
./webodm.sh restart --media-dir /storage/media --node-dir /storage/node
--media-dir è l'archivio permanente e non va spostato dopo l'inizializzazione; --node-dir contiene i file temporanei ed è spostabile.
Per l'interfaccia OpenDroneMap Desktop, opendronemap.org/download indica che su Linux è "gratis con installazione manuale". La procedura non è nella nostra scheda: seguila su docs.opendronemap.org e verifica che corrisponda alla versione che scarichi. Non riportiamo passi che non abbiamo potuto verificare.
Per il motore ODM, la documentazione indica l'installazione nativa su Ubuntu 24.04 dal repository ODM:
bash configure.sh install
Oppure via Docker, senza installazione nativa:
docker pull opendronemap/odm
Per un nodo di elaborazione con interfaccia web minima, l'immagine è opendronemap/nodeodm: la porta predefinita storica è la 3000, ma verifica nel README dell'immagine su Docker Hub il comando docker run consigliato e le variabili disponibili.
La guida passo passo è Linux (Ubuntu) con Docker.
Server e VPS#
Su un server la differenza è nell'interfaccia: la linea WebODM si installa come su Linux e aggiunge SSL e nome host con due opzioni; la linea OpenDroneMap offre sul server il nodo NodeODM o il motore ODM, mentre per l'interfaccia completa non esiste un repository open da clonare.
Su Ubuntu LTS: sudo apt-get update && sudo apt-get upgrade, installa Docker e docker compose, clona il repository come sopra ed esegui ./webodm.sh start. Apri la porta TCP 8000 nel firewall e raggiungi http://IP:8000.
Per HTTPS con certificato Let's Encrypt e un nome di dominio:
./webodm.sh restart --ssl --hostname webodm.miaazienda.it
Altre opzioni utili: --gpu (richiede driver NVIDIA e NVIDIA Container Toolkit), --ipv6, --with-micmac. L'elenco completo è in ./webodm.sh --help.
Sul server puoi avviare un nodo NodeODM con l'immagine opendronemap/nodeodm, che espone una REST API e un'interfaccia web minima per caricare immagini e lanciare elaborazioni. Porta predefinita storica 3000: verifica nel README dell'immagine. Per un'esposizione pubblica servono un reverse proxy e HTTPS configurati da te, perché il nodo non li include.
In alternativa, elaborazioni non interattive con opendronemap/odm da riga di comando, lanciate via SSH o da uno scheduler.
Per un'interfaccia completa della linea OpenDroneMap su server, la scheda non registra una via documentata: OpenDroneMap Desktop è un prodotto desktop. Verifica su opendronemap.org e docs.opendronemap.org se la situazione è cambiata.
La guida dedicata è Server, cloud e VPS, e per i nodi NodeODX, ClusterODX e nodi remoti.
Riga di comando: il solo motore#
Qui le due linee sono più simili che altrove. La sintassi è la stessa; cambia solo il nome dell'immagine Docker. È anche la via che useremo nel protocollo di misura di Stesso dataset, due motori.
Il motore ODX è distribuito come immagine webodm/odm. Verifica il tag disponibile su Docker Hub prima di scaricare, poi:
docker pull webodm/odm
docker run -ti --rm -v /home/utente/datasets:/datasets webodm/odm --project-path /datasets progetto
Le immagini vanno in /home/utente/datasets/progetto/images. Le opzioni di ODX sono documentate su docs.webodm.org, pagina delle opzioni; per vedere quelle della tua immagine: docker run --rm webodm/odm --help.
Il motore ODM è distribuito come immagine opendronemap/odm:
docker pull opendronemap/odm
docker run -ti --rm -v /home/utente/datasets:/datasets opendronemap/odm --project-path /datasets progetto
Le immagini vanno in /home/utente/datasets/progetto/images. Le opzioni sono su docs.opendronemap.org/arguments; per vedere quelle della tua immagine: docker run --rm opendronemap/odm --help.
La cartella progetto deve esistere prima del comando e contenere la sottocartella images. I risultati compaiono nella stessa cartella. La guida completa è ODM e ODX da riga di comando.
Cloud#
La linea WebODM offre WebODM Lightning (webodm.net), un servizio di UAV4GEO che funziona come nodo remoto per la tua installazione di WebODM: alla data di verifica offre 150 crediti gratuiti ai nuovi utenti, tariffa a consumo e garanzia di 30 giorni; l'archiviazione temporanea è stata ridotta da 14 a 10 giorni nel giugno 2026. La linea OpenDroneMap non offre un servizio cloud proprio; il motore si può eseguire su un server tuo con le vie descritte sopra. Il confronto tra locale, server proprio e cloud è nel blog: WebODM in locale o nel cloud.
Come verificare
Al termine dell'installazione, la verifica dipende dalla via scelta.
Linea WebODM: l'interfaccia risponde su http://localhost:8000 (Docker) o si apre da sola (installer); docker images mostra immagini con prefisso webodm/; git remote -v nella cartella del clone mostra WebODM/WebODM.
Linea OpenDroneMap: OpenDroneMap Desktop si apre e mostra la versione; docker images mostra opendronemap/odm o opendronemap/nodeodm; docker run --rm opendronemap/odm --version stampa la versione di ODM.
Se docker images mostra entrambi i prefissi, leggi Repository, immagini Docker e migrazioni per capire cosa hai.
Problemi frequenti#
Out of memory durante l'elaborazione. Vale per entrambe le linee: aumenta la RAM assegnata a Docker (Docker Desktop: Settings → Resources) o riduci --pc-quality e --feature-quality. Vedi Ottimizzare tempi e memoria.
"No space left on device". Il disco virtuale di Docker Desktop è di 20 GB per impostazione predefinita: aumentalo. Su Linux controlla lo spazio della partizione di Docker.
Su Windows lo script Docker fallisce. Abilita la virtualizzazione (VT-x) nel BIOS e verifica che WSL2 sia attivo. Vale per entrambe le linee quando usi Docker Desktop.
Ho seguito una guida del 2024 che clona github.com/OpenDroneMap/WebODM. Quell'indirizzo oggi reindirizza a github.com/WebODM/WebODM, quindi ottieni la linea WebODM. Se vuoi essere esplicito, usa direttamente il nuovo indirizzo.
La GPU non viene rilevata. Linea WebODM: driver NVIDIA più NVIDIA Container Toolkit, verifica con nvidia-smi, avvia con --gpu. Linea OpenDroneMap: la documentazione di ODM dichiara che la GPU non porta benefici; controlla su docs.opendronemap.org lo stato attuale.
Il catalogo completo è in Errori comuni.
Prossimi passi#
- Capisci cosa c'è dietro i nomi delle immagini e come cambiare linea: Repository, immagini Docker e migrazioni.
- Lancia il primo progetto: Primo progetto passo passo.
- Se stai ancora decidendo la via, l'albero decisionale è in Quale versione scegliere.
Fonti
- Download di WebODM (installer e Docker): https://webodm.org/download/(link esterno)
- Installazione di WebODM, requisiti, opzioni di webodm.sh: https://docs.webodm.org/installation/(link esterno)
- Repository di WebODM: https://github.com/WebODM/WebODM(link esterno)
- Download di OpenDroneMap Desktop, edizioni e prezzi: https://www.opendronemap.org/download/(link esterno)
- Installazione di ODM (Docker, nativa, requisiti): https://docs.opendronemap.org/installation/(link esterno)
- Repository di ODM, script configure.sh e release: https://github.com/OpenDroneMap/ODM(link esterno)
Guide correlate
ODM e ODX a confronto: cosa hanno in comune e cosa cambia
Confronto ODM/ODX · Base · Entrambe le linee
Requisiti hardware WebODM e OpenDroneMap: RAM, CPU, disco, GPU
Iniziare · Base · Entrambe le linee
Installare WebODM o OpenDroneMap Desktop su Windows
Installazione · Base · Entrambe le linee
Installare WebODM e ODM su Ubuntu con Docker Engine
Installazione · Intermedio · Entrambe le linee
ODM e ODX da riga di comando con Docker
Installazione · Avanzato · Entrambe le linee
OpenDroneMap Desktop: installazione su Windows, macOS e Linux
Installazione · Base · Solo OpenDroneMap / ODM
Errori comuni di WebODM e OpenDroneMap: significato e rimedi
Risoluzione problemi · Intermedio · Entrambe le linee