pulumi-netbird

README

Pulumi NetBird Native Provider

Project still in WIP

This repository contains the Pulumi NetBird Provider, a native Pulumi provider built in Go using the pulumi-go-provider SDK. It enables you to manage NetBird resources—like networks, peers, groups, and access rules—declaratively using Pulumi's infrastructure-as-code framework.

NetBird is a modern, WireGuard-based mesh VPN. This provider integrates NetBird into Pulumi for seamless infrastructure automation.

Features

• Manage NetBird resources using Pulumi in Go
• Built natively with Pulumi's Go SDK
• Includes example configurations for local testing

Prerequisites

Ensure the following are installed and available in your $PATH:

• Go 1.24+
• pulumictl
• Pulumi CLI

Build and Test

make help                 # Get all commands

Example Usage

Navigate to the example directory:

cd examples/simple
pulumi stack init test
pulumi up

This deploys a sample NetBird configuration using the provider.

Repository Structure

• provider/ – Go implementation of the provider
• sdk/go/netbird/ – Go SDK for the NetBird provider
• examples/ – Example Pulumi projects using the provider
• Makefile – Task runner for build, install, and test operations

References

• Pulumi Go Provider Docs
• NetBird Documentation
• Pulumi Command Provider (example implementation)