Skip to content

lmatfy/terraform-provider-unifi

 
 

Repository files navigation

Acceptance Tests

Unifi Terraform Provider (terraform-provider-unifi)

Note You can't (for obvious reasons) configure your network while connected to something that may disconnect (like the WiFi). Use a hard-wired connection to your controller to use this provider.

Functionality first needs to be added to the go-unifi SDK.

Documentation

You can browse documentation on the Terraform provider registry.

Supported Unifi Controller Versions

Currently this provider is tested against Docker versions of the v5 and v6 controller. The UDM and UDM-Pro versions are slightly different (the API is proxied a little differently) but for the most part should also be supported. Individual patch versions of the controller are not tested, just the latest stable versions.

There are some differences to be aware of between v5 and v6 controller usages (AP groups vs WLAN groups as an example), but in many cases, the provider should warn or error if used incorrectly. Examples will mostly show v6 usage, and a future major version of the provider will probably remove v5 support.

When reporting issues, please include your controller version and the method you use to run it.

Using the Provider

Terraform 0.13 and above

You can use the provider via the Terraform provider registry.

Terraform 0.12 or manual installation

You can download a pre-built binary from the releases page, these are built using goreleaser (the configuration is in the repo). You can verify the signature and my key ownership via Keybase.

If you want to build from source, you can simply use go build in the root of the repository.