Need help with terraform-provider-unifi?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

paultyng
253 Stars 37 Forks Mozilla Public License 2.0 224 Commits 21 Opened issues

Description

Terraform provider for Unifi :satellite:

Services available

!
?

Need anything else?

Contributors list

# 35,697
Terrafo...
Go
net-fra...
c-sharp
168 commits
# 453,002
Shell
unifi
Go
ubiquit...
11 commits
# 432,153
Docker
unifi
Go
ubiquit...
9 commits
# 316,462
Amazon ...
golang
unifi
Terrafo...
6 commits
# 195,489
C#
CSS
Shell
unifi
3 commits
# 19,056
PHP
hg
Git
phabric...
2 commits
# 658,535
Shell
unifi
Go
ubiquit...
1 commit
# 610,673
Shell
unifi
Go
ubiquit...
1 commit
# 207,823
nagios
chef-re...
HTML
jenkins...
1 commit
# 111,076
jenkins...
nuxtjs
Nuxt.js
k8s
1 commit
# 673,512
Shell
unifi
Go
ubiquit...
1 commit
# 191,769
Go
ubiquit...
Terrafo...
chrome-...
1 commit
# 381,321
C
CSS
javascr...
sed
1 commit
# 616,260
Python
Ansible
unifi
Go
1 commit
# 255,040
Shell
CSS
cloudfo...
golang
1 commit

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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.