mmshad / outline-aws-terraform

Terraform script to deploy Outline VPN on AWS

outline-aws-terraform

Terraform script to deploy Outline VPN on AWS.

Prerequisites

• The Terraform CLI (1.2.0+) installed.
• The AWS CLI installed.
• AWS account and associated credentials that allow you to create resources.

Step by Step

Follow these steps to configure your VPN,

• Install Terraform CLI (instructions page).
• Install AWS CLI (instructions page).
• Configure AWS credentials as described in this page. You can add your AWS credentials in ~/.aws/credentials file,

AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=

or add them as Environmental Variables (less secure) or use Vault by HashiCorp. Then format, validate, plan, and apply your Terraform,

terraform init
terrafrom validate
terraform plan  # dry run before applying
terraform apply

At the end of Terraform script results, look for a line with green color and {"apiUrl":"https:/. Copy this green line (including brackets ) to Outline Manager for AWS.

Custom AMI with Docker: The AMI in the variables.tf file is a default one. You can build an AMI with Docker installed to save on the Docker installation process by Outline.

Multiple Servers: For multiple VPN servers, just chance ec2_count number in variables.tf file. The default value is 1. If you increase count for multiple VPN servers, look for each {"apiUrl":"https:/ line in the Terraform output. You also need to check your AWS EC2 service quotas for permisson on multiple EC2 instances (check this page).

If you need to destroy and create a new VPN, just destroy each with

terraform plan  -destroy # dry run before applying
terraform destroy

Enjoy!