Skip to content

Deployment

Hostnames aren't updating after deployment

Tip

As you move through the setup (Namely the initial make configure step) several changes will be made to the local files that will make the configuration your own. These changes will need to be commited back to GitHub prior to running the overarching make command for deployment to work correctly. As a result, you will need to ensure that you clone the repo using a method that allows you to perform a git push after the changes are made. These methods are covered under the following URL: About Remote Repositories

Terraform errors, ie. Resource already exists

You'll need remove all of the external resources that were created by Terraform. This can be done by running the following from the homelab/external folder. 

terraform plan -destroy -out=destroy.tfplan && terraform apply destroy.tfplan

Tip

If you have issues with the above method, you can remove the resources manually by performing the following:

  • Delete any Cloudflare API keys that were created by the setup. These keys will be labeled as 'homelab_cert_manager'. It's not 100% necessary to remove these keys but will help with maintaining a cleaner setup as a new API key is generated upon each subsequent run.
  • Delete all DNS records from cloudflare that were created by cert-manager - See this Medium article on how to remove more than one record at a time via API using Postman.
  • Delete any existing Cloudflare Tunnels via the Zero Trust Dashboard under 'Access>Tunnels'.
  • Delete any existing ZeroTier networks - Login to the Dashboard, click on any existing networks. The option to delete will be at the bottom of the page.
  • Recreate the Terraform Workspace - Be sure that upon recreation you set the execution mode to 'local'.