terraform-provider-headscale
terraform-provider-headscale copied to clipboard
A terraform provider for Headscale
Terraform Provider Headscale
This is a Terraform provider for Headscale. This provider allows interaction with the Headscale API to manage and gather data on resources.
You can find this provider on the Terraform Registry.
Differences between the Tailscale and Headscale Providers
As Headscale has a different API than Tailscale, the functionality of this provider differs from what the Tailscale provider offers.
Some data sources and resources may offer similar functionality between these two providers, but for many of these the configuration options and functionality will be different. This provider contains data sources and resources the Tailscale provider does not offer and lacks some that it does.
Getting Started
To install this provider in your project, you can copy the code snippet below into your project then run terraform init
.
terraform {
required_providers {
headscale = {
source = "awlsring/headscale"
version = "0.1.1"
}
}
}
provider "headscale" {
api_key = "api_key"
endpoint = "https://headscale.example.com"
}
In the provider
block you will need to replace api_key
and endpoint
with the values for your Headscale instance. These can also be set via the environment variables HEADSCALE_API_KEY
and HEADSCALE_ENDPOINT
.
For further details on how to use this provider, please see the documentation in the /docs
section of this repo or on the Terraform Registry page.