# Self-hosted prerequisites

> What you need before the first command: AWS access, a domain, DNS and a GitHub organization admin.

Source: https://diakrin.com/docs/self-hosted/prerequisites

You need one AWS administrator, one domain name and a GitHub organization admin before you run the first command.

## Before you start

| You need | Example | Notes |
| --- | --- | --- |
| An AWS account and region | `eu-west-1` | A region listed as supported by the [release](/docs/self-hosted/releases) |
| The AWS CLI v2, signed in with admin rights | `aws sts get-caller-identity` works | One administrator installs Diakrin end to end |
| A host name | `diakrin.example.com` | A name you control. Diakrin is served at `https://<host>` |
| DNS for that name | Route 53 in this account, or any DNS provider | Route 53: records are automatic. Any other provider: the CLI prints two records early |
| A GitHub organization admin | `your-org` | Installs the Diakrin GitHub App and sets its webhook |
| A Mac or Linux computer | Terminal with `curl` and `sh` | Installs the Diakrin CLI |
| Audit retention | 365 days | Cannot be shortened after the first install |
| A Diakrin license file (optional) | `acme-license.json` | Not needed to install. See [License](/docs/self-hosted/license) |

## AWS requirements

- At least 2 vCPU of Fargate On-Demand quota and 2 Availability Zones in the region.
- With the default exposure (`cloudfront`) the VPC needs an internet gateway. A new VPC created by Diakrin has one.
- The AWS role you sign in with can create VPC, ECS, RDS, ALB, ECR, KMS, ACM, S3, IAM, CloudFront and WAF resources. `AdministratorAccess` is the simplest choice for the install.

> [!NOTE]
> The signed-in role is only used from your computer. After the install nothing in Diakrin needs administrator access.

## Check your setup

```sh
aws sts get-caller-identity
```

You should see the 12-digit account id of the account you want to install into. If it shows another account, switch profile before you continue.

```sh
aws --version
```

You should see `aws-cli/2`.

## Next

[Install Diakrin](/docs/self-hosted/install).
