Skip to main content
Deploy Omni to AWS using Terraform for production-ready infrastructure with auto-scaling and multi-AZ redundancy. For development or single-server deployments, see Docker Compose Deployment.

Prerequisites

  • AWS account with administrative access
  • Terraform 1.0+
  • AWS CLI configured (aws configure)
  • GitHub container registry access (provided during onboarding)
  • Domain name for the application

Quick Start

Edit terraform.tfvars:
See Configuration Reference for all options.

Deploy

Deployment takes 15-20 minutes. Get outputs when complete:
Create a CNAME record pointing your domain to the ALB DNS name, then access at https://omni.<your domain>.com.

Infrastructure Overview

Scaling

Apply with terraform apply.

Updating

Re-download the Terraform artifact for the new release and re-apply:

Backups

Monitoring

Container Insights is enabled by default for ECS metrics. Use log_retention_days (default: 30) to control CloudWatch log retention.

Destroying

Troubleshooting

See Troubleshooting Guide for detailed diagnostics.

Next Steps