Concepts

Projects

One project per codebase or shipped artifact you need an SBOM for.

What is a project

A project belongs to an organization and collects every SBOM pushed for that codebase. SBOMBox keeps the history, so you can see how the quality score, open vulnerabilities and ruleset results change from release to release. Create projects in the app; each one has a name, a slug and a UUID.

sbombox projects list
sbombox projects use <project-uuid>

projects use writes project_id to .sbombox.yml, so commit that file and everyone on the repository pushes to the same place. In CI, set SBOMBOX_PROJECT instead, or pass --project to push.

Branches and versions

Each upload carries a branch (default main) and an optional version label, so release SBOMs stay separate from feature-branch builds:

sbombox push sbom.json --branch release/2.x --version v2.3.0

Settings

Projects inherit settings from their organization. A project can override any setting the organization has not enforced, such as the rulesets it is checked against.