Incus Image Registry
Lab Operator · Simplestreams
● Live
Custom Incus VM Images
Sysbox-enabled Kubernetes and k3s agent node images, published as a native Incus Simplestreams remote. Add this registry once and launch pre-built VMs instantly. 
# Add this registry as an Incus remote
incus remote add lab-images https://incus-images.pages.dev --protocol=simplestreams

Getting Started

1
Add the remote
incus remote add lab-images https://incus-images.pages.dev --protocol=simplestreams
This registers the registry as a trusted Incus image source on your machine.
2
Browse available images
incus image list lab-images:
The image is downloaded from the GitLab Package Registry on first use and cached locally.
4
Pin to a specific version
# Append /<version> to pin an exact release (version = git commit SHA)
incus launch lab-images:sysbox-k3s-agent/<version> my-agent-node --vm

# Example
incus launch lab-images:sysbox-k3s-agent/bda1eb0 my-agent-node --vm
Click any version chip in the Available Images section below to copy its exact launch command.
5
Join a k3s cluster (k3s-agent image only)
incus exec my-agent-node -- bash -c \
  "curl -sfL https://get.k3s.io | K3S_URL='https://<server>:6443' K3S_TOKEN='<token>' sh -"

Available Images

Loading images…

Version Pinning

Use a Specific Version
Every published image version corresponds to a Git commit SHA. Pin to an exact version for reproducible environments by appending /version to the image alias. 
# Syntax
incus launch lab-images:<alias>/<version> <instance-name> --vm

# Example: pin to a specific k3s-agent build
incus launch lab-images:sysbox-k3s-agent/bda1eb0 pinned-agent --vm
# List all available versions of a specific image
incus image list lab-images: | grep sysbox-k3s-agent
# Import a specific version into local cache without launching
incus image copy lab-images:sysbox-k3s-agent/<version> local: --alias my-pinned-agent

Registry Details

Simplestreams Protocol
Images are indexed via the Simplestreams protocol. The metadata is hosted here on Cloudflare Pages; the actual image tarballs are stored in the GitLab Generic Package Registry and downloaded on demand. 
# Index endpoint
GET /streams/v1/index.json
# Image catalog endpoint
GET /streams/v1/images.json