Skip to main content
This template deploys AgentOS to AWS with ECS Fargate, RDS PostgreSQL, and an Application Load Balancer. Production-grade infrastructure that runs entirely in your cloud.

​
Step-by-step Guide

1

Install tools

2

Create and activate a virtual environment

uv venv --python 3.12
source .venv/bin/activate
3

Install Agno

uv pip install -U 'agno[infra]'
4

Create your codebase

ag infra create --template agentos-aws --name agentos-aws

cd agentos-aws
Or clone directly: git clone https://github.com/agno-agi/agentos-aws-template.git
5

Set your API key

export OPENAI_API_KEY=sk-***
Agno works with any model provider. Just update the agents in your codebase.
6

Configure AWS settings

Update infra/settings.py with your AWS configuration:
infra_settings = InfraSettings(
    aws_region="us-east-1",
    subnet_ids=["subnet-xxx", "subnet-yyy"],
    image_repo="[ACCOUNT_ID].dkr.ecr.us-east-1.amazonaws.com",
)
7

Test locally (optional)

ag infra up
Open http://localhost:8000/docs to verify it works.
8

Deploy to AWS

ag infra up prd:aws
Press Enter to confirm. This creates:
  • Docker image pushed to ECR
  • RDS PostgreSQL instance
  • ECS Cluster, Service, and Task Definition
  • Application Load Balancer with Target Group
RDS takes about 5 minutes to provision. Monitor progress on the AWS Console.
9

Get your endpoint

Find your Load Balancer DNS in the AWS Console (EC2 → Load Balancers). Navigate to https://<load-balancer-dns>/docs to see your AgentOS API.
10

Connect your AgentOS to the control plane

  1. Open os.agno.com
  2. Click “Connect OS” and select “Live”
  3. Enter your Load Balancer DNS as the endpoint
AgentOS connection dialog

​
Tips

Update deployment: After making changes to your agents: 
ag infra patch prd:aws
Stop deployment: 
ag infra down prd:aws
This removes all AWS resources including the database. Back up your data first.
Project structure: 
agentos-aws/
├── agents/              # Your agents
├── teams/               # Your teams
├── workflows/           # Your workflows
├── app/                 # AgentOS directory
├── db/                  # Database tables
├── infra/               # AWS infrastructure configuration
│   └── settings.py      # InfraSettings (region, subnets, etc.)
├── compose.yml          # Docker Compose for local testing
├── Dockerfile           # Container build
└── pyproject.toml       # Python dependencies
AWS Resources Created: The ag infra up prd:aws command provisions:
  • ECR: Container registry for your Docker image
  • ECS Fargate: Serverless container hosting
  • RDS PostgreSQL: Managed database with pgvector
  • Application Load Balancer: HTTPS endpoint
  • AWS Secrets Manager: Secure credential storage
  • Security Groups: Network access controls
Cost Estimate: Estimated monthly costs (US East):
  • ECS Fargate: $30-50
  • RDS db.t3.micro: $15-20
  • Load Balancer: $20-25
Total: ~$65-100/month. Use the AWS Pricing Calculator for detailed estimates.

​
Troubleshooting

The RDS instance takes about 5 minutes to provision. Check status in the AWS Console (RDS → Databases).
View task logs in CloudWatch. Common issues: missing environment variables, incorrect database connection string.
The ECS service may still be starting. Wait 2-3 minutes for health checks to pass.