Skip to main content
Last updated: 14 Jan 2026

govuk-infrastructure: Create a new environment

This document describes how to deploy govuk-infrastructure into a GOV.UK AWS account for the first time.

Prerequisites

You will need an AWS account for the new environment, and administrator access to that account.

govuk-infrastructure depends on the govuk-aws repository for some AWS resources and essential services such as the VPC, databases, message queues and so on. Eventually all these resources will move to this repository. Until then we must deploy govuk-infrastructure into an existing GOV.UK AWS account containing the old EC2 and Puppet stack.

Terraform

We organise our Terraform code into several root modules, which we call deployments.

To deploy the root modules, see Applying Terraform.

GOV.UK apps deployment

We deploy GOV.UK apps with ArgoCD, and store the config in the app-config helm-chart of the govuk-helm-charts GitHub repository.

We document our CI/CD process in the CI/CD section of the GOV.UK Kubernetes cluster docs.