imgsrv
imgsrv is an HTTP service for storing, cataloging, publishing, and serving
disk and VM image artifacts. It pairs verified content-addressed uploads with
immutable image versions, movable aliases, proxied artifact downloads, local
and OIDC publisher auth, and an Incus-compatible Simple Streams read surface.
Start where your role fits.
Run imgsrv
Documentation for the people who deploy and operate the service.
- Deploy imgsrv — production deployment against PostgreSQL and S3-compatible object storage.
- Manage authentication — bootstrap principals, rotate API tokens, configure OIDC publishers.
- Operate imgsrv — health, metrics, backups, upgrades, and triage of failed publish jobs.
Publish images
Documentation for the people whose CI or release tooling pushes images.
- Publish image versions — the canonical immutable release flow.
- Consume images — read published artifacts and subscribe Incus to the Simple Streams projection.
Other entry points
- Publish your first image — an end-to-end guided walkthrough, useful first read for either role.
- Concepts — the model behind the system: publishing, auth, and the trust boundary.
- Reference — flags, metrics, state machines, and the role-to-endpoint matrix.
- OpenAPI v1 — the wire contract.