> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runlayer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ECS + Terraform

> Deploy and operate self-hosted Runlayer in your AWS account with ECS and Terraform

Runlayer's ECS Terraform module provisions the application services and supporting AWS infrastructure in **your account**. The standard configuration creates a VPC, load balancer, Aurora PostgreSQL, ElastiCache Redis, Secrets Manager secrets, and ECS Fargate services. Optional GPU features also use EC2.

You own the AWS account, Terraform state, configuration, upgrades, and recovery. Runlayer provides application artifacts, onboarding credentials, and support. See [Shared Responsibility](/operations/shared-responsibility).

## Deployment path

Follow these pages in order:

1. Collect [Runlayer-provided inputs](/deployment/runlayer-provided-inputs) and review [egress requirements](/deployment/egress-requirements).
2. Complete [ECS prerequisites](/deployment/ecs-prerequisites): tools, AWS identity, state storage, domain, and Bedrock access.
3. Choose [networking and private connectivity](/deployment/ecs-networking), [database and service configuration](/deployment/ecs-configuration), and any [optional features](/deployment/ecs-features) required at launch.
4. Follow the [deployment guide](/deployment/terraform): configure, initialize, validate, plan, apply, and verify.
5. Use [Updates](/operations/updates) and the [module changelog](/deployment/terraform-changelog) for subsequent releases.

## Artifacts and versions

| Artifact | Delivery | Version |
| - | - | - |
| Terraform module | Private S3 bucket `runlayer-infrastructure-modules` | Pin a module release, such as `v33.1.0` |
| Application images | Customer Distribution private ECR, account `088332244652` | Module default, or a compatible explicit `app_version` |

Module and application versions are separate. The [module changelog](/deployment/terraform-changelog) lists the application default for each release. The [Terraform inputs reference](/deployment/terraform-ecs-inputs) documents configuration; it is not the installation sequence.

Runlayer grants S3 download and ECR pull access during onboarding. Confirm access for the deployment identity and runtime image-pull identity before starting.

## Plan capacity and cost

Use the [AWS Pricing Calculator](https://calculator.aws/) with your region, service replica counts, Aurora ACUs, Redis sizing, NAT gateways, logs, data transfer, and optional GPU capacity. Feature selection and availability requirements materially change the cost; the default configuration is not a fixed-price deployment.

For Kubernetes on EKS or GKE, see [Kubernetes](/deployment/kubernetes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.