{"id":13710873,"url":"https://github.com/e-breuninger/terraform-provider-netbox","last_synced_at":"2025-12-26T00:38:47.705Z","repository":{"id":37026570,"uuid":"288719776","full_name":"e-breuninger/terraform-provider-netbox","owner":"e-breuninger","description":"Terraform provider to interact with Netbox","archived":false,"fork":false,"pushed_at":"2025-03-31T04:12:08.000Z","size":1831,"stargazers_count":205,"open_issues_count":105,"forks_count":145,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-04-01T09:34:32.189Z","etag":null,"topics":["netbox","terraform","terraform-provider"],"latest_commit_sha":null,"homepage":"https://registry.terraform.io/providers/e-breuninger/netbox/latest/docs","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/e-breuninger.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-19T12:00:13.000Z","updated_at":"2025-03-28T07:26:14.000Z","dependencies_parsed_at":"2023-10-16T10:11:16.797Z","dependency_job_id":"a0c8a14c-983f-44c9-9053-0059758f01f9","html_url":"https://github.com/e-breuninger/terraform-provider-netbox","commit_stats":{"total_commits":860,"total_committers":92,"mean_commits":9.347826086956522,"dds":0.5395348837209302,"last_synced_commit":"740effe727b116de8cce5abe15dc6b170477c95c"},"previous_names":["flxpeters/terraform-provider-netbox"],"tags_count":105,"template":false,"template_full_name":"hashicorp/terraform-provider-scaffolding","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e-breuninger%2Fterraform-provider-netbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e-breuninger%2Fterraform-provider-netbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e-breuninger%2Fterraform-provider-netbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e-breuninger%2Fterraform-provider-netbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/e-breuninger","download_url":"https://codeload.github.com/e-breuninger/terraform-provider-netbox/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247829511,"owners_count":21002997,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["netbox","terraform","terraform-provider"],"created_at":"2024-08-02T23:01:01.670Z","updated_at":"2025-12-26T00:38:47.699Z","avatar_url":"https://github.com/e-breuninger.png","language":"Go","funding_links":[],"categories":["Terraform","Automation"],"sub_categories":[],"readme":"# terraform-provider-netbox\n\nThe Terraform Netbox provider is a plugin for Terraform that allows for the full lifecycle management of [Netbox](https://netboxlabs.com/docs/netbox/) resources.\nThis provider is maintained by E. Breuninger.\n\nSee: [Official documentation](https://registry.terraform.io/providers/e-breuninger/netbox/latest/docs) in the Terraform registry.\n\n## Requirements\n\n- [Terraform](https://www.terraform.io/downloads.html) \u003e= 0.12.x\n\n## Supported netbox versions\n\nNetbox often makes breaking API changes even in non-major releases. Check the table below to see which version a provider was tested against. It is generally recommended to use the provider version matching your Netbox version. We aim to always support the latest minor version of Netbox.\n\nSince version [1.6.6](https://github.com/e-breuninger/terraform-provider-netbox/commit/0b0b2fffa54d4ab2e5f1677e948b01e56ba211c8), each version of the provider has a built-in list of all Netbox versions it supports at release time. Upon initialization, the provider will probe your Netbox version and include a (non-blocking) warning if the used Netbox version is not supported.\n\n| Netbox version  | Provider version |\n| --------------- | ---------------- |\n| v4.3.0 - 4.4.0  | v5.0.0 and up    |\n| v4.2.2 - 4.2.9  | v4.0.0 - 4.3.1   |\n| v4.1.0 - 4.1.11 | v3.10.0 - 3.11.1 |\n| v4.0.0 - 4.0.11 | v3.9.0 - 3.9.2   |\n| v3.7.0 - 3.7.8  | v3.8.0 - 3.8.9   |\n| v3.6.0 - 3.6.9  | v3.7.0 - 3.7.7   |\n| v3.5.1 - 3.5.9  | v3.6.x           |\n| v3.4.3 - 3.4.10 | v3.5.x           |\n| v3.3.0 - 3.4.2  | v3.0.x - 3.5.1   |\n| v3.2.0 - 3.2.9  | v2.0.x           |\n| v3.1.9          | v1.6.0 - 1.6.7   |\n| v3.1.3          | v1.1.x - 1.5.2   |\n| v3.0.9          | v1.0.x           |\n| v2.11.12        | v0.3.x           |\n| v2.10.10        | v0.2.x           |\n| v2.9            | v0.1.x           |\n\n## Building The Provider\n\n1. Clone the repository\n1. Enter the repository directory\n1. Build the provider using the Go `install` command:\n\n```sh\ngo install\n```\n\n## Installation\n\nStarting with Terraform 0.13, you can download the provider via the Terraform registry.\n\nFor further information on how to use third party providers, see the [Terraform documentation](https://www.terraform.io/docs/configuration/providers.html)\n\nReleases for all major plattforms are available on the release page.\n\n## Using the provider\n\nHere is a short example on how to use this provider:\n\n```hcl\nprovider \"netbox\" {\n  server_url = \"https://demo.netbox.dev\"\n  api_token  = \"\u003cyour api token\u003e\"\n}\n\nresource \"netbox_platform\" \"testplatform\" {\n  name = \"my-test-platform\"\n}\n```\n\nFor a more examples, see the [provider documentation](https://registry.terraform.io/providers/e-breuninger/netbox/latest/docs).\n\n## Developing the Provider\n\nIf you wish to work on the provider, you need [Go](http://www.golang.org) installed on your machine.\n\nTo compile the provider, run `go install`. This will build the provider and put the provider binary in the `$GOPATH/bin` directory.\n\nTo generate or update documentation, run `make docs`.\n\nIn order to run the suite of unit tests, run `make test`.\n\nIn order to run the full suite of acceptance tests, run `make testacc`.\n\nIn order to run a single specific acceptance test, run\n\n```sh\nTEST_FUNC=\u003ctest_name\u003e make testacc-specific-test\n```\n\nFor example:\n\n```sh\nTEST_FUNC=TestAccNetboxLocationDataSource_basic make testacc-specific-test\n```\n\n_Note:_ Acceptance tests create a docker compose stack on port 8001.\n\n```sh\nmake testacc\n```\n\nIf you notice a failed test, it might be due to a stale netbox data volume. Before concluding there is a problem,\nrefresh the docker containers by running `docker-compose down --volumes` in the `docker` directory. Then run the tests again.\n\nIf you get `too many open files` errors when running the acceptance test suite locally on Linux, your user limit for open file descriptors might be too low. You can increase that limit with `ulimit -n 2048`.\n\n## Contribution\n\nWe focus on virtual machine management and IPAM. If you want to contribute more resources to this provider, feel free to make a PR.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fe-breuninger%2Fterraform-provider-netbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fe-breuninger%2Fterraform-provider-netbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fe-breuninger%2Fterraform-provider-netbox/lists"}