How opendronemap/nodeodm works
Project type and purpose
• NodeODM is a Node.js–based REST API server (“backend”) that orchestrates aerial‐image processing jobs by spawning OpenDroneMap (ODM) engines in containers. It implements the standard NodeODM API used by clients such as WebODM, CloudODM and PyODM.
File structure
• Top level:
• index.js – entry point, sets up HTTP server (Express) and routes
• config.js / config-default.json – configuration loader
• Dockerfile(.gpu/.gpu.intel) + apptainer.def – container builds
• public/ – static web assets (CSS/JS/locales) for UI demos
• libs/ – core modules: auth, task & process management, ODM runner, S3 support, logging, utilities
• helpers/ – scripting helpers (Python, batch)
• scripts/ – post‐processing, bundling scripts
• services/ – OS service unit files (systemd)
• processes.json – PM2 process manager config
• contrib/docker-compose.* – multi‐container orchestration examples
• tests/ – mock data and unit/integration tests
• Patterns: modular folder per concern, adapter pattern for auth (NoToken, SimpleToken, IP), storage (local FS vs. S3), plugin‐style task runner, test‐mode stubs.
Insights from README
• Describes Docker and Apptainer deployment
• Exposes API docs in docs/index.adoc
• Supports GPU (via CUDA‐enabled base image), Windows bundle, PM2 process management
• “Test mode” simulates ODM calls using tests/ mocks