Skip to main content
Warning This document has not been updated for a while now. It may be out of date.
Last updated: 24 Jul 2023

govuk-infrastructure: Create a new environment

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


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

govuk-infrastructure depends on govuk-aws 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, govuk-infrastructure needs to be deployed into an existing GOV.UK AWS account containing the old EC2/Puppet stack.


The Terraform code is organised into several root modules, which we call deployments.

To deploy the root modules, see Applying Terraform.

GOV.UK apps deployment

GOV.UK apps are deployed by ArgoCD and the config is stored in the app-config helm chart of the govuk-helm-charts GitHub repository.

See CI/CD in the GOV.UK Kubernetes cluster docs.