Guide: Metronome in Digital Ocean

This guide will walk you through the steps to install Metronome in Digital Ocean, but the same steps can be used for any other cloud provider that you can ssh into.

1. Create a Digital Ocean Droplet

Create an Ubuntu droplet. You can use the cheapest option, but make sure it has at least 2GB of RAM and 2 CPUs. At the end, it will depends on your ingestion rate.

2. Install Docker Compose

SSH into your droplet and install Docker Compose.
$apt install -y docker-compose

3. Assign a Reserved IP to your Droplet

Assign a reserved IP to your droplet. This will ensure that your droplet will always have the same IP address.

4. Configure your domain name

Add an
record to your domain name to point to your droplet IP address. Such as

5. Clone the Metronome repository

SSH into your droplet and clone the Metronome repository.
$git clone

6. Run the setup script

To create the necessary configuration files and start Metronome, run the setup script.
$cd docker
$./ --maxmind-license MAXMIND_LICENSE --url DOMAIN_NAME
This will create a
file with the necessary configuration to start Metronome.

7. Start Metronome

$docker-compose up -d; docker-compose logs --tail="all" -f
After the migrations are set up and the server is running, you can access Metronome at
You will be able to create the admin user when you access Metronome for the first time.

Updating Metronome self hosted

To update Metronome, you need to pull the updated docker images and restart the containers.
$docker pull metronomedotsh/metronome:latest
$docker-compose down && docker-compose up -d