Skip to main content
Last updated: 14 Jan 2026

govuk-infrastructure: setting-up-content-delivery-network

GOV.UK uses Fastly as its Content Delivery Network (CDN).

Setting-up

To setup Fastly, log into the Fastly web management portal.

TLS certificate

  1. Choose a domain that users will use to reach your GOV.UK environment, e.g. the GOV.UK Elastic Kubernetes Service (EKS) platform uses a domain with format www.eks.<environment>.govuk.digital
  2. Create a Fastly/Let's Encrypt TLS certificate for your chosen domain and attach it to the govuk TLS configuration.
  3. Create a CNAME to point to the address in the value of the variable www_dns_validation_rdata in the commons.yaml file belonging to the environment you are deploying; for example, the file for the integration environment is located at terraform/deployments/variables/integration/common.tfvars

CDN service

  1. In the Fastly portal, create a new CDN service, e.g. <environment> GOV.UK EKS. You should use the same domain that you have chosen above. Make a note of the new service ID.
  2. Create a pull request in the govuk-cdn-config-secrets GitHub repository with a new service under www-eks. You can use an example pull request to guide you.
  3. See how to deploy Fastly.