> For the complete documentation index, see [llms.txt](https://docs.boringdata.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.boringdata.io/template-aws-iceberg/introduction/get-started.md).

# Get Started

## Prerequisites

Before you begin, ensure you have the following tools installed on your local machine:

* **Git**
* **Python 3.12**
* **AWS CLI**
* **Terraform (v1.0+)**
* **Terragrunt**: Wrapper for managing Terraform configurations
* **Docker**
* **Make**
* **uv**: Python package management tool

## AWS Credentials

Set up your AWS credentials in the `~/.aws/credentials` file:

```bash
[YOUR_PROFILE]
region=your-region
aws_access_key_id=YOUR_ACCESS_KEY
aws_secret_access_key=YOUR_SECRET_ACCESS_KEY
```

{% hint style="warning" %}
Don't forget to include the region in your profile
{% endhint %}

{% hint style="info" %}
Your AWS user should have permission listed in this [example policy](https://github.com/boringdata/boringdata-template-aws-iceberg/blob/main/init/init_aws_tf_user_policy.json) file (less privilege).
{% endhint %}

## Quick Start

For a quick start with local deployment and local Terraform state:

```bash
# Set your AWS profile and environment name
export AWS_PROFILE=<your_profile>
export ENVIRONMENT=<environment>

# Deploy the infrastructure and Docker images
make deploy
```

This command will:

1. Deploy all Terraform modules in the correct order
2. Build and push Docker images for the ingestion and transformation pipelines

## Verify Your Deployment

After deployment completes:

1. Navigate to the AWS Step Functions service
2. Find your pipeline's step function (e.g., `dev-chess-step-function`)
3. Execute the step function with an empty payload
4. Monitor the execution to verify the pipeline runs successfully

<figure><img src="/files/gWaz2PlyVokT92tbGOuQ" alt="" width="375"><figcaption></figcaption></figure>

## Next Steps

After your initial deployment, you might want to:

1. [Add a New Pipeline](/template-aws-iceberg/guides/add-a-pipeline.md) - Create your own data pipeline
2. [CI Deployment](/template-aws-iceberg/guides/production-deployment.md) - Set up production deployment with CI/CD
3. [FAQ](/template-aws-iceberg/help/faq.md) - Find answers to frequently asked questions