Add new AWS users

This utility is being replaced with cod-cli (https://github.com/GovWifi/cod-cli).

The remainder of this section is retained until everyone has migrated to cod-cli

You can add new AWS users to the GovWifi AWS accounts by following the instructions below:

Ensure the person has been added to the central AWS user management account gds-users, if they haven’t they can request to be added via this form.
Verify with the GovWifi developers whether to grant admin or read-only access. Only team members with security clearance can be allowed admin access. Until security clearance is passed read-only access is allowed.
Add the user with the appropriate privileges to the Terraform code that describes GovWifi’s account. You need to get the pull request approved and merged by Reliability Engineering.
Deploy the Terraform changes by:

a. Navigate to the GovWifi account directory Terraform:
```
  cd terraform/deployments/re-govwifi/account/
```
b. Using the gds-cli, note: gds-cli is being migrated to cod-cli, gds-cli may be aliased to ‘gds’, initialise Terraform if you have not done so previously:
```
  gds aws govwifi -- terraform init
```
c. Run plan on the Terraform project to ensure the changes are what you intend to deploy:
```
  gds aws govwifi -- terraform plan
```
d. Run apply on the Terraform changes if you are happy to proceed:
```
  gds aws govwifi -- terraform apply
```

This page was last reviewed on 7 August 2025. It needs to be reviewed again on 7 February 2026 by the page owner #govwifi .