Openwrt Terraform Provider

Openwrt Provider for Terraform (or OpenTofu).

Prerequisites

• Terraform or OpenTofu
• An OpenWRT Router
• luasocket luci-mod-rpc luci-lib-ipkg and luci-compat packages installed in the openwrt router

Installation

This provider is published in the Terraform Registry.

Quick Example

Add the following to your Terraform configuration:

terraform {
  required_providers {
    openwrt = {
      source = "foxboron/openwrt"
    }
  }
}

Documentation

Full documentation can be found in the docs directory.

Development

Prerequisites

• Golang
• Make
• Golangci-lint
• GoReleaser

Setup

1. Checkout the repository git clone ...
2. Compile from sources to a development binary:

cd terraform-provider-openwrt
make build

3. Configure Terraform (~/.terraformrc) to use the development binary provider:

$ cat ~/.terraformrc
provider_installation {
  dev_overrides {
    "foxboron/openwrt" = "/<PATH_WHERE_YOU_EXECUTED_GIT_CLONE>/terraform-provider-openwrt"
  }
  direct {}
}