Builds service

The /builds service orchestrates container builds, multi-architecture pipelines, and full flashable Pantavisor images on Pantacor build runners. It turns Git repositories (or pinned registry images) into signed pvr exports ready to deploy directly to Pantavisor devices.

For step-by-step walkthroughs, see the Builds Guide.

Core concepts

• Pipelines: Builds for multiple target architectures (amd64, arm64, arm32v6) are submitted in a single request and run in parallel as child executions under a parent pipeline.
• Sources: Builds accept a Git repository URL (with branch, tag, or commit) or a digest-pinned registry image (image@sha256:...). Repositories can build from a Dockerfile or a pvpkg.json manifest (including Yocto/kas and Buildroot).
• Secrets & Signing: Private repository tokens and signing keys are managed as account secrets (/secrets / pvr secret) and referenced by name. Artifacts can be signed with account OEM keys or developer keys.
• Artifacts: Produced .pvrexport.tgz archives are published directly to the account's object store and downloaded with SHA-256 verification.

Endpoints

Method	Path	Description
POST	/builds	Submit a new build or multi-arch pipeline
GET	/builds	List builds and pipelines with filtering
GET	/builds/{id}	Get status, phase, and metadata of a build
GET	/builds/{id}/logs	Retrieve live or completed runner build logs
POST	/builds/{id}/cancel	Cancel a queued or running build
POST	/builds/{id}/retry	Re-queue a finished build with same parameters
GET	/builds/{id}/artifacts/{name}	Download a verified build artifact
GET	/builds/usage	Inspect account build minute quota and usage

Authentication

Calls require a Pantahub user JWT bearer token with the builds scope (or builds.write and builds.readonly).

Guides & references

• How builds work — Architecture, stages, and lifecycle
• In the web UI — Using the Hub web console
• With pvr CLI — Submitting and managing builds via pvr build
• From GitHub Actions — CI/CD workflow integration
• Flashable device images — Generating .img.xz images
• Secrets & signing — Account secrets and pvs signing