How-to change Terraform Enterprise Administrator E-mail via Rails

Introduction

Expected Outcome

Change Administrator E-mail in Terraform Enterprise which is greyed out in admin setting page.

Prerequisites

•  Terraform Enterprise

Use Case

• You no longer have access to the Administrator email configured.
• Promoting another account as Site Admin is not an option.

Procedure

1. SSH into your Terraform Enterprise instance.

2. Launch the Rails console.  

   sudo docker exec -it ptfe_atlas /usr/bin/init.sh /app/scripts/wait-for-token -- bash -i -c 'cd /app && ./bin/rails c'

   For Terraform Enterprise v202205-1 through v202308-1: 

   sudo docker exec -it tfe-atlas /usr/bin/init.sh /app/scripts/wait-for-token -- bash -i -c 'cd /app && ./bin/rails c'

3. For Terraform Enterprise v202309-1 and above running in consolidated_services mode: 

   sudo docker exec -it terraform-enterprise tfectl support console

4. Find the Administrator account and store it in the user variable. 

   user = User.find_by(email: 'administrator@email.com')

5. Change the email for the user. The email address must not be currently in use by any other user.

   user.email = 'yournewadminemail@email.com'

6. Save your changes and exit the Rails console.

   user.save!
   exit

7. You should now be able to see the new email in the admin setting in Terraform Enterprise Web UI.

Additional Information

• How To Access the Terraform Enterprise Rails Console