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

# AWS Setup Guide for Ditto BYOC

> Deploy Ditto Server on Amazon Web Services

This guide covers the specific requirements and steps for deploying Ditto's Bring Your Own Cloud (BYOC) solution on Amazon Web Services (AWS).
This is a guided process where a Ditto engineer will work with a customer engineer with suitable access in the desired account.

***

## Customer Pre-requisites

<Steps>
  <Step title="Create a Ditto account">
    Create a Ditto account on the [Ditto Homepage](https://portal.ditto.live) by clicking on "Get Started"
  </Step>

  <Step title="Identify a suitable AWS account">
    We recommend using a dedicated account for Ditto to deploy into, if possible. We can however deploy into any account of the customer's choosing. Every effort is made to ensure that access permissions are minimal.
  </Step>

  <Step title="Identify a region to deploy into">
    For deployments based in the United States, `us-east` and `us-west` are the currently recommended regions. See [Supported Regions](#supported-regions) for more information.
  </Step>

  <Step title="Increase service quotas, if necessary">
    See [Service Quotas](#service-quotas).
  </Step>

  <Step title="Identify an individual with suitable access to perform provisioning">
    This individual should have admin permissions to create IAM roles and policies in the AWS Account.
  </Step>
</Steps>

***

### Supported Regions

Ditto BYOC is fully supported in the following AWS regions:

* **us-east-1 and us-east-2:** Eastern United States
* **us-west-1 and us-west-2:** Western United States

Additional regions available upon request. Contact our support team for region-specific requirements.

***

### Service Quotas

The current AWS service quota requirements are as follows:

| Quota Name                                                       | Quota Code | Required Value |
| ---------------------------------------------------------------- | ---------- | -------------- |
| Running On-Demand Standard (A, C, D, H, I, M, R, T, Z) instances | L-1216C47A | 100            |

***

## Deployment Process

<Steps>
  <Step title="Account Provisioning">
    The initial setup is a guided process conducted with a Ditto engineer:

    <Steps>
      <Step title="Pre-deployment Call">
        Review prerequisites and deployment requirements
      </Step>

      <Step title="CLI Tool Delivery">
        Receive dedicated bootstrap script for initial setup
      </Step>

      <Step title="VPC Configuration">
        Deploy dedicated VPC or configure existing infrastructure
      </Step>

      <Step title="Cluster Deployment">
        Ditto deploys Kubernetes cluster with appropriate sizing
      </Step>

      <Step title="Database Deployment">
        Begin deploying databases via the Ditto Portal
      </Step>
    </Steps>
  </Step>

  <Step title="Sizing Recommendations">
    Start with the v1-small configuration, our recommended initial cluster size. Our team will work with you to right-size the deployment based on your production workload requirements.
    The three main scalable components are:

    * Subscription Server: Horizontally scalable based on device connections
    * API Server: Scales with HTTP API usage
    * Store: Scales with data volume and throughput requirements
  </Step>
</Steps>

***

## Cost Considerations

When running Ditto BYOC on AWS:

* Costs include:
  * EC2 instance hours
  * EBS / SSD / S3 storage
  * Data transfer
  * Load balancer hours
* Consider using Reserved Instances or Savings Plans for cost optimization
* Leverage your existing AWS credits and enterprise agreements

***

## AWS-Specific FAQ

<AccordionGroup>
  <Accordion title="Can I use existing VPCs?">
    Yes, but Ditto recommends dedicated VPCs for isolation and easier management.
  </Accordion>

  <Accordion title="What about AWS GovCloud?">
    Contact Ditto for GovCloud deployment options.
  </Accordion>
</AccordionGroup>

***

> For AWS-specific setup assistance or questions, please [contact support](https://support.ditto.com).