Quick start
Push your first tracked image in under five minutes. All you need is Docker (or crane) and a running oci-bai stack.
Prerequisites
- Stack running —
make up(gateway on:8080) - Docker or
cranefor pushing images - The
oci-baiCLI on yourPATH
No setup needed
Repositories are created automatically on first push.
Steps
1
Push an image through the gateway
Tag any image for the gateway and push. Derivation from shared layers is inferred automatically.
bash
docker tag my-image:latest localhost:8080/my-repo:v1 docker push localhost:8080/my-repo:v1
Using crane?
crane push my-image.tar localhost:8080/my-repo:v1 --insecure2
Confirm the commit was recorded
bash
oci-bai --repo my-repo log v1
You should see the commit id, manifest digest, and who pushed it.
3
Push a derived image
Push a second image built from the first. oci-bai links them automatically.
bash
docker push localhost:8080/my-repo:v2 oci-bai --repo my-repo provenance v2
4
Browse in the dashboard
Open the dashboard and select my-repo.
- Versions — the full commit graph
- Provenance — derivation tree for any version
- Compare — diff any two versions
5
Search
bash
oci-bai search "cuda>=12.4" oci-bai search "format==safetensors" oci-bai search "numpy==1.26.4 arch==arm64"