# AWS ECS with Terraform (/docs/sombra/deploying/deployment-options/ecs-terraform)

While we previously recommended AWS ECS Fargate as our primary hosting option for Sombra, we now recommend [Kubernetes/Helm-based deployments](./helm.mdx) for their cloud-agnostic support and enhanced capabilities. AWS Fargate does not support GPU nodes, making it unsuitable for deployments requiring the LLM Classifier.

That said, the ECS deployment option remains supported for environments where Kubernetes isn't available or practical. Be aware that our future infrastructure-as-code updates will prioritize the Helm chart implementation.

<Callout type="info">
  **Prerequisites**

  Follow our [Getting Started guide](../getting-started.mdx#step-1-create-a-transcend-api-key) to get access to our container registry, and get all the environment variables you'll need when configuring Sombra.
</Callout>

## Step 1: Deploy to AWS ECS via Terraform [#step-1-deploy-to-aws-ecs-via-terraform]

Use the example ECS Terraform configuration in [the module's example folder](https://github.com/transcend-io/terraform-aws-sombra/tree/master/example). Note that you may already have an existing VPC where you want to deploy Sombra, in which case you can omit the VPC module.

For a complete list of customizable fields, refer to the module's [variables file](https://github.com/transcend-io/terraform-aws-sombra/blob/master/variables.tf).

Add the following `default_tags` block to your AWS provider configuration. This AWS Partner Revenue Measurement (PRM) tag lets AWS attribute your Sombra infrastructure spend to Transcend's Marketplace listing.

```terraform
provider "aws" {
  region = "eu-west-1"

  default_tags {
    tags = {
      # AWS Partner Revenue Measurement tag for Transcend Marketplace listing attribution
      aws-apn-id = "pc:qr1idavg3tjmhbta7ff8hpvc"
    }
  }
}
```

## Step 2: Test the Transcend Ingress [#step-2-test-the-transcend-ingress]

Go to the [Sombra Gateways](https://app.transcend.io/infrastructure/sombra/sombras) page and click the "Test" button under "Test Gateway Connection" to make a GET request to the `/test` endpoint of the Sombra Gateway.

![Buttons to test the Sombra connection](/images/screenshot/2025-03-14-sombra-test-connection.png)

You should see a successful message if the connection is working. Congratulations on successfully deploying Sombra!

## Limitations Compared to Kubernetes Deployments [#limitations-compared-to-kubernetes-deployments]

When using ECS for Sombra deployments, be aware of these limitations:

1. No support for GPU-based workloads, such as the LLM Classifier
2. Less flexibility for scaling and resource management
3. AWS-specific deployment, making migration to other cloud providers more difficult
