Installation ยป Production Rack

Amazon Web Services

Please note that these are instructions for installing a Rack via the command line. The easiest way to install a Rack is with the Convox Web Console

Initial Setup

AWS CLI

Terraform

Convox CLI

Environment

The following environment variables are required:

  • AWS_ACCESS_KEY_ID
  • AWS_SECRET_ACCESS_KEY

Create IAM User

$ aws iam create-user --user-name convox
$ aws iam attach-user-policy --user-name convox --policy-arn arn:aws:iam::aws:policy/AdministratorAccess
$ aws iam create-access-key --user-name convox
  • AWS_ACCESS_KEY_ID is AccessKeyId
  • AWS_SECRET_ACCESS_KEY is SecretAccessKey

Install Rack

$ convox rack install aws <name> [param1=value1]...

Available Parameters

Name Default Description
cidr 10.1.0.0/16 CIDR range for VPC
node_disk 20 Node disk size in GB
node_type t3.small Node instance type
private true Put nodes in private subnets behind NAT gateways
region us-east-1 AWS Region
syslog Forward logs to a syslog endpoint (e.g. tcp+tls://example.org:1234)