How Can We Help?

ODK Aggregate on Digital Ocean

You are here:
< All Topics

ODK Aggregate Installation on Digital Ocean 

Digital Ocean has proven to be an easy way to get ODK Aggregate running, with less technical knowledge required than other types of cloud-based servers. 

 

To use this setup, you must able to link a domain name to the machine’s IP address. If you don’t own a domain, services such as FreeDNS offer free sub-domains under a range of domains.

You will also need a Digital Ocean account

Create your Droplet

  1. Log into DigitalOcean and create a new Droplet.
  2. Select the distribution for your new Droplet: Select the option 18.04.x x64 from the Ubuntu box.

Digital Ocean Ubuntu Selection 

  1. Choose a size fit for your intended usage. The $5 Standard Droplet should be enough for light Aggregate use. If you find yourself needing more, DigitalOcean makes it easy to resize to a bigger Droplet.
  2. If you would like automatic weekly backups, enable them. 

Please refer to the Data Backup, Protection, and Loss section of this manual to read more about determining your backup frequency

  1. You will not need block storage.
  2. Choose a datacenter region physically close to where data collection is going to happen.

Please refer to our Data Center Considerations section of the beginning of the handbook to understand the importance of selecting a center right for your team. 

  1. Under Select additional options, check the User data checkbox. 

Copy and Paste the contents of this Cloud-Config script.

2. In the Choose a hostname section, enter the domain name (e.g., your.domain). This hostname will be used by the Cloud-Config script to configure your server’s HTTPS support.

3. You will not need to add public SSH keys (unless you know what that is and you want to).

4. Click on the Create button. The Droplet takes a few seconds, the actual Aggregate installation will take up to 10 minutes to complete.

Set up your domain

  1. Once the Droplet is running, take note of its public IP address (e.g., 12.34.56.78) and set a DNS A record pointing to it.
  2. Open a web browser, and periodically check the domain until you see the Aggregate website. You won’t be able to continue the install until you see the website load.
  3. Enable HTTPS
  4. From the DigitalOcean Control Panel, click the name of your droplet, then select Access from the left navigation. Click the Launch Console button to open a web-based console session.
  5. When the console opens, click the console screen, and at the login prompt, enter the user: root. Your password will be the root password that DigitalOcean emailed you.
  6. Once you are logged in, run sudo certbot run –nginx –non-interactive –agree-tos -m YOUR_EMAIL –redirect -d YOUR_DOMAIN.

Replace YOUR_EMAIL and YOUR_DOMAIN with your email address and your domain name

Log into Aggregate

  1. Go to https://your.domain and check that Aggregate is running.
  2. Click Sign in with Aggregate password to login with the default username and password.
  3. Change the administrator account’s password
Previous ODK Aggregate Introduction
Next ODK Briefcase Installation
Table of Contents