# Install jenkins-job-builder with Homebrew, apt, Nix

Configure Jenkins jobs with YAML files stored in Git. Version 6.5.0 via Homebrew; verified 2026-05-25.

## Install

```sh
sudo av install brew:jenkins-job-builder
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install jenkins-job-builder
```

  Evidence: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install jenkins-job-builder
```

  Evidence: Debian stable package indexes: jenkins-job-builder from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#jenkins-job-builder
```

  Evidence: nixpkgs package indexes: jenkins-job-builder from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix

## Package facts

- **Package key:** brew:jenkins-job-builder
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/jenkins-job-builder>
- **Version:** 6.5.0
- **Source summary:** Configure Jenkins jobs with YAML files stored in Git
- **Homepage:** <https://docs.openstack.org/infra/jenkins-job-builder/>
- **Repository:** <https://opendev.org/jjb/jenkins-job-builder>
- **Upstream docs:** <https://jenkins-job-builder.readthedocs.io/en/latest>
- **License:** Apache-2.0
- **Source archive:** <https://files.pythonhosted.org/packages/af/c9/b2fa858f3825c0347a201d0e542c0235605167fcb61b161648585b5ab248/jenkins_job_builder-6.5.0.tar.gz>
- **Last updated:** 2026-05-25T00:00:08Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- jenkins-jobs (cli)
- jenkins-jobs (alias)

## Dependencies

- certifi
- libyaml
- python@3.14

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 6.5.0
- Package-manager updated: 2026-05-25
- Local data: ok
- Upstream repository: https://docs.openstack.org/infra/jenkins-job-builder/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Jenkins Job Builder is a Python tool that converts YAML or JSON job definitions into Jenkins job configuration. Its package-manager role is to put the `jenkins-jobs` executable on a developer or CI administration machine so Jenkins jobs can be generated and updated from version-controlled text.

### Project history

The project is documented with a 2012-2026 maintainer copyright range and has long been associated with the OpenStack/OpenDev infrastructure ecosystem. The OpenDev repository presents it as tools for making Jenkins jobs from templates and records the OpenDev migration patch in 2019.

The README says Jenkins Job Builder takes human-readable YAML or JSON descriptions of Jenkins jobs, uses them to configure Jenkins, and includes a flexible template system for creating many similar jobs.

### Adoption history

JJB became useful to infrastructure teams that wanted Jenkins jobs reviewed like code. Instead of treating the Jenkins web UI as the source of truth, teams could keep job definitions in Git, generate XML, test definitions locally, and upload changes through a repeatable CLI.

### How it is used

The documentation describes YAML or JSON job definition files, directories of definitions, job templates, projects, macros, and defaults. The execution docs show `jenkins-jobs test` for generating XML locally and `jenkins-jobs update` for uploading job and view definitions to a configured Jenkins server.

### Why package nerds care

JJB is a classic infrastructure-as-code package from the pre-Pipeline era of Jenkins administration. It matters to package nerds because it bridges human-editable job declarations, generated Jenkins XML, and distro-friendly Python packaging, preserving a workflow that predates many newer Jenkins configuration systems.

### Timeline

- 2012: early project files and licensing history appear in the repository.
- 2014: sample and reference-test material appears in the repository history.
- 2019: the project migrated into the OpenDev namespace.
- 2024: Read the Docs configuration was added to the repository.

### Related projects

- Jenkins is the target automation server whose jobs and views JJB configures.
- OpenDev and the former OpenStack infrastructure tooling are historically connected to JJB's repository and review workflow.
- python-jenkins and PyYAML are related implementation dependencies named by the README for non-setup.py installation.

### Sources

- <https://jenkins-job-builder.readthedocs.io/en/stable/>
- <https://jenkins-job-builder.readthedocs.io/en/stable/definition.html>
- <https://jenkins-job-builder.readthedocs.io/en/stable/execution.html>
- <https://opendev.org/jjb/jenkins-job-builder>


## Security Notes

No matching local secret-handling manifest was found for jenkins-job-builder. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.config/jenkins_jobs/jenkins_jobs.ini, <script directory>/jenkins_jobs.ini, /etc/jenkins_jobs/jenkins_jobs.ini

## Credential files

- Unix: ~/.config/jenkins_jobs/jenkins_jobs.ini, <script directory>/jenkins_jobs.ini, /etc/jenkins_jobs/jenkins_jobs.ini
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** jenkins-job-builder
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Debian apt - jenkins-job-builder - 6.4.2-3: normalized package name match | Debian stable package indexes: jenkins-job-builder from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Configure Jenkins using YAML files - metapackage | https://opendev.org/jjb/jenkins-job-builder
- Debian apt - jenkins-job-builder-doc - 6.4.2-3: normalized package name match | Debian stable package indexes: jenkins-job-builder-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Configure Jenkins using YAML files - doc | https://opendev.org/jjb/jenkins-job-builder
- Debian apt - python3-jenkins-job-builder - 6.4.2-3: normalized package name match | Debian stable package indexes: python3-jenkins-job-builder from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Configure Jenkins using YAML files - Python 3.x | https://opendev.org/jjb/jenkins-job-builder
- Nix - jenkins-job-builder: normalized package name match | nixpkgs package indexes: jenkins-job-builder from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix
- Ubuntu apt - jenkins-job-builder - 3.11.0-6: normalized package name match | Ubuntu 24.04 LTS package indexes: jenkins-job-builder from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Configure Jenkins using YAML files - metapackage | http://ci.openstack.org/jenkins-job-builder
- Ubuntu apt - jenkins-job-builder-doc - 3.11.0-6: normalized package name match | Ubuntu 24.04 LTS package indexes: jenkins-job-builder-doc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Configure Jenkins using YAML files - doc | http://ci.openstack.org/jenkins-job-builder
- Ubuntu apt - python3-jenkins-job-builder - 3.11.0-6: normalized package name match | Ubuntu 24.04 LTS package indexes: python3-jenkins-job-builder from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Configure Jenkins using YAML files - Python 3.x | http://ci.openstack.org/jenkins-job-builder


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [dagger](https://www.automicvault.com/pkg/brew/dagger/) - Shares av.db curated category or tags: automation, ci-cd, cli, developer-tools.
- [gitea-runner](https://www.automicvault.com/pkg/brew/gitea-runner/) - Shares av.db curated category or tags: automation, ci-cd, cli, developer-tools.
- [jenkins](https://www.automicvault.com/pkg/brew/jenkins/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools, jenkins.
- [jenkins-cli](https://www.automicvault.com/pkg/brew/jenkins-cli/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools, jenkins.
- [jenkins-lts](https://www.automicvault.com/pkg/brew/jenkins-lts/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools, jenkins.
- [pipelight](https://www.automicvault.com/pkg/brew/pipelight/) - Shares av.db curated category or tags: automation, ci-cd, cli, developer-tools.
- [tfcmt](https://www.automicvault.com/pkg/brew/tfcmt/) - Shares av.db curated category or tags: automation, ci-cd, cli, developer-tools.
- [act](https://www.automicvault.com/pkg/brew/act/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools.
- [git-review](https://www.automicvault.com/pkg/brew/git-review/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, developer, developer-tools, git.

## Combined YAML source

View the package source record on GitHub. [combined/jenkins-job-builder.yml](https://github.com/automic-vault/db/blob/main/combined/jenkins-job-builder.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
