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 with Docker. You can use this Digital Ocean Docker Template. Make sure it has at least 4GB of RAM and 2 CPUs. At the end, it will depends on your ingestion rate.

2. 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.

3. Configure your domain name

Add an
A
record to your domain name to point to your droplet IP address. Such as
metronome.yourdomain.com
.

4. Clone the Metronome repository

SSH into your droplet and clone the Metronome repository.
Terminal
$git clone https://github.com/metronome-sh/docker.git

5. Run the setup script

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

6. Start Metronome

Terminal
$docker compose up -d;
After the migrations are set up and the server is running, you can access Metronome at
https://metronome.yourdomain.com
.
You will be able to create the admin user when you access Metronome for the first time.

Updating Metronome self hosted

Having accessed the droplet, you can update Metronome by following the steps below:

1. Pull the latest commit from the repository

Terminal
$cd docker
$git pull

2. Rebuild the web and the worker containers

Terminal
$docker-compose build web worker --no-cache

3. Docker compose up

Terminal
$docker-compose up -d