Create and Manage Snapshots

Create a snapshot from a Docker image, connect GitHub Container Registry, and understand snapshot build states.

Use the Snapshots page to create and manage the sandbox images your agents depend on.

Have these details ready:

If the image lives in GitHub Container Registry, connect GitHub first so the workspace can authenticate to ghcr.io.

The snapshots area includes a GitHub connection panel. Use it when:

If the GitHub connection is expired or missing, snapshot creation from GHCR may be blocked until you reconnect.

Snapshot creation runs in the background, so you can close the dialog and keep working while the image is being prepared.

The snapshots table uses statuses such as:

If a snapshot stays pending longer than expected, check the image reference, GitHub connection, and entrypoint.

Create a fresh snapshot instead of reusing an old one when:

That gives you cleaner rollback and clearer operational history.

Connect GitHub For GHCR Images

The snapshots area includes a GitHub connection panel. Use it when:

your image is private

you want Salambo to authenticate automatically to GHCR

you need to validate or reconnect an existing GitHub connection

If the GitHub connection is expired or missing, snapshot creation from GHCR may be blocked until you reconnect.

Create The Snapshot

Open Snapshots.

Choose New Snapshot.

Enter a unique snapshot name.

Enter the Docker image reference, for example ghcr.io/org/image:v1.

Set the entrypoint. The Salambo default is typically /app/start.sh.

Choose the runtime type, such as codex or pi.

Choose the sandbox size.

Submit the form.

Snapshot creation runs in the background, so you can close the dialog and keep working while the image is being prepared.