# AWS Deployment Guide {#aws-deployment-guide}


Deploy Ever Gauzy to Amazon Web Services (AWS).


## Architecture {#architecture}






```mermaid
graph TB
    ALB[Application Load Balancer] --> ECS1[ECS: API Service]
    ALB --> ECS2[ECS: Webapp]
    ECS1 --> RDS[(RDS PostgreSQL)]
    ECS1 --> EC[(ElastiCache Redis)]
    ECS1 --> S3[(S3: File Storage)]
    Route53[Route 53] --> ALB
    ACM[ACM: SSL] --> ALB
```






## Services Used {#services-used}


| AWS Service     | Purpose                 |
| --------------- | ----------------------- |
| ECS (Fargate)   | Container orchestration |
| RDS             | PostgreSQL database     |
| ElastiCache     | Redis caching           |
| S3              | File storage            |
| ALB             | Load balancing          |
| Route 53        | DNS management          |
| ACM             | SSL certificates        |
| Secrets Manager | Secret storage          |
| CloudWatch      | Monitoring & logs       |


## Quick Start with ECS {#quick-start-with-ecs}



### 1. Create RDS PostgreSQL {#1-create-rds-postgresql}


```bash
aws rds create-db-instance \
  --db-instance-identifier gauzy-db \
  --db-instance-class db.t3.medium \
  --engine postgres \
  --master-username gauzy \
  --master-user-password your-password \
  --allocated-storage 50
```


### 2. Create ElastiCache Redis {#2-create-elasticache-redis}


```bash
aws elasticache create-cache-cluster \
  --cache-cluster-id gauzy-redis \
  --engine redis \
  --cache-node-type cache.t3.micro \
  --num-cache-nodes 1
```


### 3. Create ECS Task Definition {#3-create-ecs-task-definition}


```json
{
  "family": "gauzy-api",
  "containerDefinitions": [
    {
      "name": "api",
      "image": "ghcr.io/ever-co/gauzy-api:latest",
      "portMappings": [{ "containerPort": 3000 }],
      "environment": [
        { "name": "DB_TYPE", "value": "postgres" },
        { "name": "DB_HOST", "value": "gauzy-db.xxx.rds.amazonaws.com" },
        {
          "name": "REDIS_HOST",
          "value": "gauzy-redis.xxx.cache.amazonaws.com"
        },
        { "name": "FILE_PROVIDER", "value": "S3" },
        { "name": "AWS_S3_BUCKET", "value": "gauzy-uploads" }
      ]
    }
  ]
}
```


### 4. Configure S3 File Storage {#4-configure-s3-file-storage}


```
FILE_PROVIDER=S3
AWS_ACCESS_KEY_ID=your-key
AWS_SECRET_ACCESS_KEY=your-secret
AWS_REGION=us-east-1
AWS_S3_BUCKET=gauzy-uploads
```


## Cost Estimate {#cost-estimate}


| Service         | Size           | Monthly Cost |
| --------------- | -------------- | ------------ |
| ECS Fargate (2) | 1 vCPU, 2GB    | ~$60         |
| RDS             | db.t3.medium   | ~$70         |
| ElastiCache     | cache.t3.micro | ~$15         |
| S3              | 10GB           | ~$1          |
| ALB             | Standard       | ~$20         |
| **Total**       |                | **~$166/mo** |


## Related Pages {#related-pages}


- [Production Deployment](https://sourcey-gauzy.pages.dev/devops/production-deployment/index.md) — general guide
- [Environment Variables](https://sourcey-gauzy.pages.dev/devops/environment-variables/index.md) — configuration
- [Scaling & HA](https://sourcey-gauzy.pages.dev/devops/scaling/index.md) — scaling guide