Community, supporto e formazione per WebODM e OpenDroneMap

Prima di chiedere#

Il software libero non ha un numero verde, ma ha una community di utenti e sviluppatori che leggono e rispondono, a una condizione: che la domanda sia fatta bene. Prima di scrivere, cerca il tuo messaggio di errore nel catalogo Errori comuni e nella FAQ, poi nella documentazione e nei canali della community: la maggior parte dei problemi è già stata risolta. Infine raccogli i dati elencati più sotto: senza, la prima risposta sarà una richiesta di fornirli.

1. I canali ufficiali#

Dopo la separazione del 6 aprile 2026, WebODM e OpenDroneMap hanno community distinte. La tabella ti aiuta a scegliere.

Due avvertenze. Le issue su GitHub servono per i bug, non per le domande d'uso: "perché la mia ortofoto ha dei buchi" va sul Discord o sul forum. E il forum OpenDroneMap conserva l'archivio delle discussioni precedenti alla separazione, quando WebODM e ODM erano un solo progetto: per i problemi del motore resta una miniera, anche se oggi usi ODX.

I canali sono in inglese. Un inglese semplice, con il log incollato, funziona benissimo: i lettori sono abituati a utenti da tutto il mondo.

2. Come fare una buona domanda#

Una richiesta di aiuto efficace contiene sei elementi. Preparali in un file di testo e poi incollali.

1. Versione e distribuzione. Quale linea e quale interfaccia: WebODM (installer Windows 3.2.8, installer macOS 3.1.4, Docker con la data dell'ultimo ./webodm.sh update) oppure OpenDroneMap Desktop (edizione e versione); quale motore (ODX, ODM, MicMac) e quale nodo (locale, remoto, Lightning).
2. Sistema. Sistema operativo e versione, RAM totale e RAM assegnata a Docker, spazio libero sul disco, GPU se rilevante.
3. Cosa hai fatto. Preset o opzioni usate, in forma copiabile (dalla scheda del task puoi copiare l'elenco delle opzioni).
4. Cosa è successo. Il messaggio di errore esatto e le ultime 50–100 righe del log del task, incollate come testo o allegate. Non uno screenshot del log: il testo si cerca, l'immagine no.
5. Il dataset. Numero di immagini, camera e drone, risoluzione, quota e sovrapposizione del volo, se hai GCP o file geo. Se puoi, un link a un campione di immagini o al dataset intero: è il modo più veloce per far riprodurre il problema.
6. Il report. Se il task è arrivato a produrlo, il PDF del report di qualità dice più di mille parole. Come leggerlo tu stesso è in Leggere il report di qualità.

Aggiungi cosa hai già provato. E quando il problema si risolve, scrivi la soluzione nello stesso thread: la persona che avrà il tuo stesso errore fra sei mesi ti ringrazierà.

3. Documentazione ufficiale#

Le docs sono la fonte primaria, anche per questo sito: ogni nostra guida indica in fondo le pagine ufficiali su cui si basa.

• docs.webodm.org — installazione, uso dell'interfaccia, opzioni ("options and flags"), API. È la documentazione da consultare per WebODM, ODX, NodeODX e Lightning.
• docs.opendronemap.org — installazione, motore ODM con l'elenco completo degli argomenti (arguments), descrizione dettagliata delle fasi, NodeODM, ClusterODM. È la documentazione da consultare per la linea OpenDroneMap.

Alla data della separazione i due motori erano identici, quindi molte pagine di una documentazione valgono anche per l'altra linea. Per ogni comando, però, verifichiamo sulla documentazione della linea a cui appartiene e non deduciamo mai il comando di una linea da quello dell'altra: quando una verifica manca, lo scriviamo. Le differenze dichiarate tra i due motori sono raccolte in ODM e ODX: panoramica. Sul sito webodm.org è pubblicata una nota secondo cui le informazioni su WebODM presenti su opendronemap.org possono essere non aggiornate: la riportiamo come posizione di WebODM, non come giudizio nostro.

4. Il libro: "OpenDroneMap: The Missing Guide"#

Se vuoi capire davvero cosa fa il motore in ogni fase, il testo di riferimento è "OpenDroneMap: The Missing Guide" di Piero Toffanin, creatore di WebODM. È in inglese e si trova anche su amazon.it. Spiega la fotogrammetria come la implementa ODM, il significato delle opzioni, la lettura degli output e le strategie per i casi difficili. È stato scritto prima della separazione del 2026, quindi non tratta ODX come progetto distinto, ma le basi che descrive valgono per entrambi i motori. Questo sito non ha alcun rapporto con l'autore né con l'editore e non riceve nulla dalla vendita del libro.

5. Imparare#

Nessuna delle due linee offre, alla data di verifica, un programma di certificazione ufficiale. Imparare passa per tre strade:

• Autoformazione con le docs, il libro e i dataset di prova: la guida Dataset di prova indica dove trovare immagini libere per esercitarti senza volare, anche per confrontare le due linee sugli stessi dati.
• Community: leggere il forum e il Discord anche senza domande da fare è un modo efficace di imparare come ragionano gli utenti esperti.
• Corsi di terzi, in aula o a distanza, esistono; questo sito non ne segnala né ne consiglia alcuno. Se ne valuti uno, chiedi che copra anche i temi che riguardano l'Italia: sistemi di riferimento (RDN2008, Gauss-Boaga), quote ortometriche, normativa e GCP con strumentazione GNSS, e che dichiari su quale linea e quale versione si basa.

6. Come contribuire ai due progetti#

Il software delle due linee è libero (AGPL-3.0) e vive del lavoro di chi lo sviluppa e di chi lo usa. Puoi contribuire a entrambi in modi che non richiedono di saper programmare. Le vie sono le stesse; cambiano gli indirizzi.

Una precisazione: webodm.it non raccoglie donazioni e non gestisce denaro per conto di nessuno dei due progetti. Se vuoi sostenerli, fallo attraverso i canali che i progetti stessi indicano, ai link sopra. Segnalare a questo sito un errore in una guida, o proporre una correzione, è a sua volta un contributo alla community italiana: vedi la pagina Contatti.

7. Questo sito come punto di raccolta in italiano#

webodm.it vuole essere un riferimento in lingua italiana su WebODM/ODX e OpenDroneMap/ODM, imparziale tra le due linee. Non è un canale di supporto ufficiale e non sostituisce Discord, forum e GitHub, ma può fare tre cose.

Raccogliere gli errori e i casi che incontrate: se trovi un problema non descritto nel catalogo Errori comuni, o un'imprecisione in una guida, segnalacelo dalla pagina Contatti scegliendo "Errore in una guida". Le segnalazioni verificate finiscono nelle guide alla revisione successiva, con la data di verifica aggiornata in testa alla pagina e una riga nel Changelog.

Tradurre e contestualizzare: le docs ufficiali sono in inglese e pensate per un pubblico globale; qui trovi le stesse informazioni con i sistemi di riferimento, la normativa e i casi d'uso italiani, per entrambe le linee.

Orientare: se non sai da dove partire, i tre percorsi (appassionato, professionista, pubblica amministrazione) ordinano le guide in una sequenza di lettura.

Prossimi passi#

• Gli errori più frequenti, con causa e rimedio: Errori comuni.
• Capire chi sviluppa cosa, per scegliere il canale giusto: L'ecosistema nel 2026.
• Le domande brevi: FAQ.