Terraform Provider

Summary

Ship an official Terraform provider so teams can manage Netmaker resources as code - networks, nodes, keys, ACLs, users/groups, and gateways - via familiar IaC workflows.

Goals

• Enable declarative, repeatable provisioning of Netmaker environments
• Support GitOps / CI-CD for network and access configuration
• Reduce manual UI/API setup for MSPs and enterprise platform teams
• Keep the provider aligned with the Netmaker REST API and auth model

Scope (initial)

• Official Terraform provider (published to the Terraform Registry)
• Core resources, e.g.:
  • Networks
  • Enrollment keys
  • Nodes / hosts and wg configs (where API-manageable)
  • ACLs / access policies
  • Users, groups, and roles (Pro where applicable)
  • egress gateways (as supported by API)
• Data sources for existing networks, nodes, and related objects
• API token / OIDC-compatible auth configuration for the provider
• Docs and examples for common topologies (mesh, remote access, site-to-site)

Success criteria

• Users can create and update a working Netmaker network topology with Terraform alone
• Provider resources map cleanly to stable Netmaker APIs
• Provider is installable from the Terraform Registry with working docs/examples
• Plan/apply is safe and idempotent for supported resources