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

# Set up databases

All applications in an environment share a common database cluster.

The database cluster set up for your environment is `{Environment}-main`, and the default database is `{Environment}-main-one`.

## Step 1: Add and configure the `databases` package

repo-iac/environments/dev/

```
ok pkg add databases
```

Update `package-config.yml` with your preferences.

To use a **Serverless** database cluster (default):

repo-iac/environments/dev/databases/package-config.yml

```
Serverless:
  Enable: true
```

To use a **traditional** database cluster:

repo-iac/environments/dev/databases/package-config.yml

```
Serverless:
  Enable: false
```

## Step 2: Install the package

repo-iac/environments/dev/databases/

```
ok pkg install
```

## Step 3: Initialize and apply the `databases` stack

repo-iac/environments/dev/databases/

```
terraform init
terraform apply
```

## Step 4: Verify

Run the following command:

```
aws rds describe-db-instances | jq '.DBInstances[].DBInstanceIdentifier'
```

The output list should contain the name of the database instance you just created.

Sign in to the AWS console and navigate to **RDS**. Select **Databases** in the left-hand menu.

The list should contain the name of the database cluster you just created.

---

> [!TIP]
>
> **Commit your files**
>
> At this stage it is a good idea to commit your files.

You're done with the Database setup.

## Next step

Set up [GitHub OIDC](<https://km.oslo.systems/initial-setup-of-your-aws-environment/set-up-github-oidc/index.md>).