Installation

This page covers installing both the DroneDB CLI and Registry.

CLI Installation

The ddb command-line tool provides local data management capabilities.

Windows

• Download the latest release from GitHub
• Extract the archive and add the folder to your PATH
• Verify it's working:

C:\> ddb --version
x.x.x (git commit xxxxxxx)

note

The version number will vary depending on the release you downloaded.

Linux (Debian/Ubuntu)

Download the .deb package from the latest release and install it:

$ sudo dpkg -i dronedb_x.x.x_amd64.deb
$ ddb --version
x.x.x (git commit xxxxxxx)

note

Only Debian-based distributions (Debian, Ubuntu, Linux Mint, etc.) are officially supported.

Registry Installation

Registry is the web-based platform for hosting and sharing datasets.

Docker (Recommended)

The fastest way to get started is with Docker:

docker run -it --rm -p 5000:5000 -v ${PWD}/registry-data:/data dronedb/registry

Open http://localhost:5000 in your browser.

Default credentials: admin / password

warning

Change the default password immediately after first login at http://localhost:5000/account

Native Installation

1. Install the latest version of the DroneDB library and add it to PATH
2. Download the latest Registry release for your platform
3. Run:

./Registry.Web ./registry-data

See Registry Getting Started for more details.

Building from Source

If you need to build DroneDB from source (e.g., for development or custom configurations):

• See Building from Source