This project is a fork of paultyng/terraform-provider-unifi, updated to support the latest UniFi Network versions.
Browse the official provider documentation on the Terraform provider registry.
As of version v1.0.1, this provider supports UniFi Controller v8.4.59. Earlier versions, up to v7.4.162, were supported in the original paultyng release.
This provider is currently under active development, with efforts to update compatibility with the latest UniFi Network Controller version v8.4.59. While significant progress has been made, only a few features are fully tested and confirmed to work:
- Resource: Network
- Resource: Port Profile
Other resources and data sources may not yet be fully functional on the latest UniFi Network version, and testing is ongoing. Users should be aware that these features might work inconsistently or could break entirely when working with newer versions of the UniFi controller.
- This Terraform provider was originally created by Paul Tyng to support UniFi Network versions up to 7.4.162.
- In August 2024, this fork was initiated to extend support to newer versions of the UniFi Network software, specifically v8.4.59.
- Ongoing efforts are being made to thoroughly test and refine all functionality.
You can use the provider via the Terraform provider registry.
Note: When using this provider, ensure you're connected via a hard-wired connection to the UniFi Controller rather than WiFi, as configuring your network over a connection that could disconnect (like WiFi) is risky and may result in issues.
provider "unifi" {
controller = "https://<unifi-controller-url>"
username = "admin"
password = "password"
}
resource "unifi_network" "example" {
name = "Example Network"
# Add relevant configuration options here
}The provider has been versioned with the goal of maintaining backward compatibility where possible. However, many changes involve breaking adjustments. Updates will continue to follow semantic versioning.
This provider relies on the go-unifi SDK, also forked from Paul Tyng's original SDK, to interact with the UniFi Controller. Code generation and updates to the SDK are performed to support the latest UniFi Controller features.
Contributions are highly appreciated to ensure better compatibility with the latest UniFi Network versions. Please submit issues and pull requests to the GitHub repository.
This project is in an experimental state, and users should proceed with caution when using it in production environments. Expect rapid changes and potentially breaking updates as development progresses.