Skip to main content
This guide explains how to deploy Voidr on AWS using the Terraform package downloaded from the self-hosted installation wizard. The deployment is fully automated and provisions all required infrastructure and services.

​
Prerequisites

Before running the deployment, make sure the following tools are installed: 
# Debian/Ubuntu
sudo apt-get update && sudo apt-get install -y jq

# macOS
brew install jq

​
Deployment Flow

The deployment is executed locally using the files inside the downloaded .zip.
1

Prepare Your Environment

Ensure all prerequisites are installed and available in your shell.
The deployment script validates required binaries before execution.
2

Locate Your Private Key

During the installation wizard, you were prompted to save a private encryption key.This key is required to decrypt sensitive Terraform variables.
This is the only way to decrypt the infrastructure configuration.
3

Run the Deployment Script

Execute the automated deployment script, passing your private key as an argument.
./scripts/deploy-complete.sh "AGE-SECRET-KEY-..."
The script is idempotent and can be safely re-run if interrupted.
4

What the Script Does

The deployment script performs the following actions automatically:
  1. Decrypts Terraform variables
    (terraform.tfvars.enc → terraform.tfvars)
  2. Provisions AWS infrastructure
    • VPC
    • ECR
    • ECS (Fargate)
    • Application Load Balancer
  3. Synchronizes Docker images
    • Pulls images from GCR
    • Pushes images to ECR
  4. Starts all Voidr services
    • Platform (UI)
    • API
    • Collector
Total deployment time is approximately 15–20 minutes.

​
Security Notes

Store your private encryption key in a secure location.
It is the only way to decrypt the Terraform variables.
Never commit a decrypted terraform.tfvars file to version control.

​
Support

If you need assistance during deployment, contact your FDE. We can help with infrastructure validation, deployment issues, and post-install checks.