CONTRIBUTING to Nomad Pack

August 5, 2026 ยท View on GitHub

We welcome contributions to Nomad Pack.

To add packs, contribute to the Nomad Pack Community Registry.

Development dependencies

  • Go (see .go-version for the required version)
  • Git
  • Make

Ensure $GOPATH/bin is on your $PATH.

Build and run locally

Install required tools:

$ make bootstrap

Check go.mod and go.sum:

$ make check

Build a binary from local code. The binary is output to ./bin/nomad-pack:

$ make dev

Run the binary:

$ ./bin/nomad-pack -h

Common make targets

TargetPurpose
make bootstrapInstall all development tools
make checkVerify Go mod is tidy
make devBuild binary to ./bin/nomad-pack
make testRun the full test suite
make lintLint source code with golangci-lint

Run make help to see all available targets.