Deploy a Camus server on DigitalOcean using Terraform.

This Terraform module creates a fully-configured Camus deployment on DigitalOcean. It creates a DigitalOcean droplet, configures networking and firewall rules, creates a DNS record for the desired domain, obtains an SSL certificate via Let's Encrypt, and installs Camus, Coturn, and Nginx on the droplet.

1. You have a DigitalOcean account.
2. You have a domain (or subdomain) for your Camus instance.
3. You've configured your domain registrar to use DigitalOcean's domain servers for your domain.
4. You have the Terraform CLI installed.

Clone this repo:

$ git clone https://github.com/mrgnr/terraform-camus.git

Initialize Terraform modules & plugins:

$ cd terraform-camus && terraform init

Inside the cloned repo, create a file called my-vars.tfvars. This file will contain your settings for the deployment. There are four variables that you must set: do_token, domain, certificate_email, and ssh_key_fingerprint. See the module inputs documentation below for a list of all variables.

An example my-vars.tfvars would be:

# Required
do_token = "1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
domain = "camus.example.com"
certificate_email = "[email protected]"
ssh_key_fingerprint = "00:11:22:33:44:55:66:77:88:99:aa:bb:cc:dd:ee:ff"

# Optional
region = "tor1"
droplet_monitoring = true

Create a plan by running Terraform from the project root:

$ terraform plan -var-file my-vars.tfvars -out plan

Once you've checked the plan to make sure that it doesn't contain any unintentional changes, apply the plan to create your deployment:

$ terraform apply plan

If the previous command ran successfully, you should have a Camus instance running within a few minutes. (Note that it may take several hours for DNS records to propagate.)

You can call this module from other Terraform code, e.g.:

module "camus" {
  source = "github.com/mrgnr/terraform-camus"

  do_token = "1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
  domain = "camus.example.com"
  certificate_email = "[email protected]"
  ssh_key_fingerprint = "00:11:22:33:44:55:66:77:88:99:aa:bb:cc:dd:ee:ff"
  region = "sgp1"
  droplet_size = "s-1vcpu-2gb"
  droplet_image = "debian-10-x64"
}

The following droplet images are supported:

• debian-10-x64
• ubuntu-20-04-x64
• ubuntu-18-04-x64
• centos-8-x64
• centos-7-x64