​
Devin AWS VPC Deployment Guide

This guide outlines the process for deploying Devin in your AWS Virtual Private Cloud (VPC) environment, providing access to resources within your corporate firewall.
Terraform deployment is our recommended approach for setting up Devin in your AWS VPC. This automated method ensures consistent, repeatable infrastructure provisioning with minimal manual configuration.
Terraform Deployment Workflow

​
Prerequisites

Before beginning the Terraform deployment process, ensure you have:
  • Setup VPC for Devin (either use an existing VPC or provision a new one)
  • Ensure you have an IAM role or service account that has permission to:
    • create ec2 auto-scale instances
    • create s3 instances in your region
  • Ensure your AWS account can support instances with at least 70 virtual CPUs
  • Terraform (version 1.0 or later) installed

​
Step-by-Step Deployment Process

1

Collect AWS Environment Information

Gather the following information which will be required for the Terraform configuration:
  • AWS Account Number (12-digit number)
  • VPC ID (vpc-xxxxxxxxxxxxxxxxx)
  • Two Subnet IDs:
    • subnet-xxxxxxxxxxxxxxxxx
    • subnet-xxxxxxxxxxxxxxxxx
Helpful AWS CLI commands:
# List your VPCs
aws ec2 describe-vpcs

# List subnets in a specific VPC
aws ec2 describe-subnets --filters "Name=vpc-id,Values=<your-vpc-id>"
2

Configure Firewall Access

Ensure your endpoint security systems (user devices that will access Devin) allow access to:
  • *.devin.ai
  • *.devinenterprise.com
  • *.devinapps.com
AWS Firewall Configuration
3

Obtain Terraform Configuration and Auth Token

Contact Cognition to receive:
  1. An authentication token for pulling the hypervisor image
  2. The Terraform configuration files customized for your environment
Once you share your environment information (from Step 1), we will provide these resources to you.
4

Execute Terraform Script

We can schedule a call to execute this step together. The process involves:
  1. Extract the Terraform configuration files to a directory on your local machine: 
    mkdir -p ~/devin-terraform && cd ~/devin-terraform
# Extract files received from Cognition
  2. Initialize the Terraform environment: 
    terraform init
  3. Review the planned infrastructure changes: 
    terraform plan
  4. Apply the configuration to provision the infrastructure: 
    terraform apply
  5. Confirm the changes when prompted.
The Terraform scripts will set up all necessary components including EC2 instances, S3 buckets, security groups, IAM roles, and the hypervisor registration.
5

Run First Devin Session

After the Terraform script completes successfully, we will work together to:
  1. Verify that the resources have been created in your AWS console
  2. Run a first Devin session to ensure connectivity to the required services
  3. Debug any issues that arise with the support of Cognition team