README.md

Terraform provider for HRUI switches

This is a hobby project to create a Terraform provider for HRUI switches that are web-managed. It relies on goquery for interfacing with the web UI.

Check the documentation at:

• Terraform: HRUI Provider
• OpenToFu: HRUI Provider

HRUI ODM/OEM

This provider is developed using a Horaco (ZX-SWTG124AS) switch. Other brands that are likely to work with this provider, as they seem to be the same hardware, include:

• HRUI
• Horaco
• Sodola
• XikeStor
• AmpCom

Note

Using firmware v1.9.

Getting Started

1. Configure the provider in your Terraform configuration:

   terraform {
     required_providers {
       hrui = {
         source  = "brennoo/hrui"
         version = "= 0.1.0-alpha.1"
       }
     }
   }
   
   provider "hrui" {
     url      = "http://192.168.2.1"
     username = "admin"
     # The password can be set in HRUI_PASSWORD environment variable
   }

2. Refer to the examples folder for usage of available resources and data sources.

Contributing

Contributions are welcome! Please see the CONTRIBUTING.md file for guidelines.

License

This provider is licensed under the MPL-2.0 License.