Self-hosted (AWS)
Self-hosted prerequisites
What you need before the first command: AWS access, a domain, DNS and a GitHub organization admin.
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 |
| 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 |
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.
AdministratorAccessis the simplest choice for the install.
Check your setup
aws sts get-caller-identityYou 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.
aws --versionYou should see aws-cli/2.