DroneDB/Registry
DroneDB/Registry has 58 GitHub stars and 17 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-17 21:27 UTC. Last push 2026-11-11.
What you can do
- Dataset Management - Create, organize and share datasets with fine-grained permissions
- Interactive Visualization - View orthophotos, point clouds, 3D models and panoramas in browser
- Measurements - 2D and 3D measurement tools on maps and point clouds
- STAC Compliance - Compliant with STAC 1.1.0 and STAC API 1.0.0
Measured star growth
- in 24h
- 0
- in 7 days
- Update delayed
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Free and open source geospatial data storage platform for DroneDB.
Creative & MediaREADME.md
OriginalDroneDB Registry
DroneDB Registry is a comprehensive geospatial data management and storage platform. It provides a responsive UI, full REST API, STAC / OGC Services compliance, and a configurable processing platform.
View orthophotos, point clouds, 3D models, Vector files, 3D Tiles, Gaussian splats, panoramas and more directly in the browser with interactive measurement tools.
✨ Features
- Dataset Management - Create, organize and share datasets with fine-grained permissions
- Interactive Visualization - View orthophotos, point clouds, 3D models and panoramas in browser
- Measurements - 2D and 3D measurement tools on maps and point clouds
- STAC Compliance - Compliant with STAC 1.1.0 and STAC API 1.0.0
- OGC Services - WMS, WFS, WMTS, WCS and OGC API (Features + Tiles) served directly from any dataset
- On-Demand Processing - Automatic thumbnails, tiles, COG, streaming format generation, and build artifact downloads (COG, COPC, GPKG)
- Remote Imports - Pull datasets from another DroneDB Registry or download archives from URL, with SSRF protection and remote org/dataset browsing
- Streaming Uploads - Memory-efficient file uploads with configurable size limits
- Feature Gating - Control which processing tools users see and may run via server configuration
- 3D Tiles - Native support for the 3D Tiles streaming format
- User Management - Role-based access control with organizations, storage quotas, and optional LDAP authentication
Supported Formats
| Category | Formats |
|---|---|
| Images | JPG, JPEG, DNG, TIF, TIFF, PNG, GIF, WEBP |
| Point Clouds | LAS, LAZ, E57, PTS, XYZ, PLY* |
| 3D Models | OBJ, GLTF, GLB, PLY* |
| 3D Tiles | 3TZ |
| Gaussian Splats | SPLAT, SPZ |
| Rasters | GeoTIFF (orthophotos, DEMs) |
| Vector | GeoJSON, DXF, DWG, SHP, SHZ, FGB, TopoJSON, KML, KMZ, GPKG |
| Videos | MP4, MOV, WEBM, M4V, AVI, MKV |
| Other | Panoramas (360°), Markdown, PDF |
*PLY files are automatically classified as point clouds or 3D models based on their content.
Live Examples
- Zoo - Point cloud
- ODM Seneca - Orthophoto with measurements
- Panorama Example - 360° panorama viewer
📚 Documentation
Full documentation is available at docs.dronedb.app
| Guide | Description |
|---|---|
| Registry Guide | Installation, configuration, deployment |
| User Management | Users, roles, organizations, quotas |
| API Reference | REST API documentation |
💬 Community
Join the DroneDB Discord to get help, share feedback, discuss features, and connect with other DroneDB users
🚀 Quick Start with Docker
The fastest way to get started is with Docker. Download Docker and run:
docker run -it --rm -p 5000:5000 -v ${PWD}/registry-data:/data dronedb/registry
Data will be stored in the local folder registry-data.
Open http://localhost:5000 in your browser to start using the application.
macOS users: do not bind-mount a local folder to
/data. Docker Desktop shares host folders through virtiofs, and DroneDB cannot create dataset indexes on it. Use a named volume instead:docker volume create registry-data docker run -d --name registry --restart unless-stopped \ --platform linux/amd64 \ -p 5000:5000 \ -v registry-data:/data \ dronedb/registryThe image is built for
linux/amd64only. On Apple Silicon the--platform linux/amd64line is required, otherwise Docker stops withno matching manifest for linux/arm64/v8. Docker Desktop then runs the image through emulation (turn on Use Rosetta for x86_64/amd64 emulation in Settings → General).See macOS: use a named volume for details.
Default credentials: admin / password123
⚠️ Change the default password immediately after first login at http://localhost:5000/account
Useful Endpoints
| Endpoint | Description |
|---|---|
| /scalar/v1 | API Documentation (Scalar UI) |
| /version | Version information |
| /quickhealth | Quick health check (requires auth) |
| /health | Detailed health check (requires auth) |
| /hangfire | Background jobs dashboard (requires auth) |
| /stac | STAC Catalog root |
The log file is located in registry-data/logs/registry.txt.
Processing Platform
On-demand builds (thumbnails, tiles, COG, streaming formats) run automatically or can be triggered manually. Large downloads are offloaded to background tasks. Configuration options including per-user task limits, per-org output budgets, remote processing nodes (ODX/NodeODX), and feature gating are documented in the Registry Guide.
For production deployment with MySQL/MariaDB, see the full documentation.
🌍 OGC Services
Every dataset exposes a full suite of OGC-compliant endpoints at
/orgs/{orgSlug}/ds/{dsSlug}/{service}.
| Standard | Version | Endpoint | Notes |
|---|---|---|---|
| WMS | 1.1.1 / 1.3.0 | …/wms |
Raster layers (orthophotos, DEMs) + folder-scoped …/wms/p/{folder} |
| WFS | 2.0 | …/wfs |
Vector layers as GeoJSON / GML + folder-scoped variant |
| WMTS | 1.0.0 | …/wmts |
KVP + RESTful …/wmts/1.0.0/{layer}/{style}/{tms}/{z}/{y}/{x}.{ext} |
| WCS | 2.0.1 / 1.1.1 / 1.0.0 | …/wcs |
GeoTIFF / PNG / JPEG GetCoverage; ACCEPTVERSIONS first-match negotiation |
| OGC API: Features | 1.0 | …/ogcapi |
JSON landing, conformance, collections, items |
| OGC API: Tiles | 1.0 | …/ogcapi/collections/{id}/tiles |
MVT (pbf) for vector layers, PNG for raster |
WMTS tile formats
pbf (MVT), png, jpg / jpeg. WebP is not supported.
WCS version negotiation
WCS supports ACCEPTVERSIONS (comma-separated, client-preference order): the first
version both client and server support is selected. Supported versions:
2.0.1, 1.1.1, 1.0.0.
OGC error envelopes
Authentication failures and OGC exceptions always return the version-appropriate
XML envelope (WMS ServiceExceptionReport, WFS/WMTS/WCS ows:ExceptionReport),
not the generic Registry error page.
QGIS setup
Ready-made QGIS setup scripts are in scripts/ (qgis-test-setup.sh /
qgis-test-setup.ps1). See the OGC services documentation
for detailed QGIS configuration steps.
🛠️ Development
Requirements
- .NET 10.0 SDK
- Node.js — the frontend pins a version in
Registry.Web/ClientApp/.nvmrc; the container image builds with the current Node LTS - DroneDB Library (add to PATH)
Build from Source
git clone https://github.com/DroneDB/Registry
cd Registry
git submodule update --init --recursive
# Build Vue.js frontend (copies output to registry-data/ClientApp/)
cd Registry.Web/ClientApp
npm install
npm run pub-dev
cd ../..
# Build and run
dotnet build
dotnet run --project Registry.Web ./registry-data
For production builds, use
npm run build:prodinstead ofnpm run pub-dev.
Run Tests
dotnet test
🐳 Docker Build
docker build . -t dronedb/registry
📄 License
This project is dual-licensed. See LICENSE.md for details.
🤝 Contributing
Contributions are welcome! Please see the contributing guidelines.