> **Page index:** https://km.oslo.systems/llms.txt lists every page on this site, with a link to its Markdown version.

# Set up environment

## Step 1: Create environment directory

Navigate to the directory where you checked out the repository:

```
# Replace <~/projects/repo-iac> with your repository location
cd ~/projects/repo-iac
```

Create a directory to hold your environments (`dev`, `qa`, `prod`, etc.):

repo-iac/

```
mkdir environments
cd environments/
```

Create a directory for your first environment (using `dev` as example):

repo-iac/environments/

```
mkdir dev
cd dev/
```

## Step 2: Create configuration file

Create `common-config.yml` in the `dev/` directory:

repo-iac/environments/dev/common-config.yml

```
AccountId: "1234567890"
Region: "eu-west-1"
Team: "pirates"
Environment: "pirates-dev"
```

| Parameter | Description | Validation |
| --- | --- | --- |
| `AccountId` | AWS account ID where the environment is created. [How to find your account ID?](<https://km.oslo.systems/aws-account/find-my-aws-account-id/index.md>). |  |
| `Region` | AWS region where the environment is created. Typically: `eu-west-1`. |  |
| `Team` | Team name. Used as part of AWS resource names. | Alpha-numeric and dashes |
| `Environment` | Environment name. Used as part of AWS resource names, for example the S3 bucket created to store the `remote_state`. **Note**: Recommended to contain the environment (dev/prod/staging). | Alpha-numeric and dashes |

This file applies to all templates in the `dev` stack.

## Next step

Set up [remote state](<https://km.oslo.systems/initial-setup-of-your-aws-environment/set-up-remote-state/index.md>) to create the S3 bucket and DynamoDB table for storing Terraform state remotely.