Skip to content

v0.5.0

Choose a tag to compare

@github-actions github-actions released this 02 Mar 12:41
· 130 commits to main since this release

Highlights

Native Incus backend (now the default). Connect directly to a local or remote Incus daemon — no TrueNAS required. Console and exec go through the Incus WebSocket API, eliminating the SSH dependency for the default workflow.

Extensible sandbox architecture. pixels now uses a pluggable backend interface. Container lifecycle, exec, snapshots, and network policy are all defined by the sandbox.Sandbox interface, making it straightforward to add new backends.

TrueNAS remains fully supported as an alternative backend, selected via backend = "truenas" in config or PIXELS_BACKEND=truenas.

What's New

  • Sandbox interface — new sandbox.Sandbox composite interface (Backend, Exec, NetworkPolicy) with a registry for self-registering backends (sandbox.Register, sandbox.Open).
  • Incus backend — manages containers via the native Incus Go client. Supports local unix socket and remote HTTPS connections with TLS client certs. Exec/console uses Incus WebSocket API with terminal resize handling. Snapshots use native Incus snapshot API (storage-backend agnostic). Clone uses CopyInstance.
  • Backend selection — backend config key (default "incus"), PIXELS_BACKEND env var, and new [incus] config section with socket, remote, client_cert, client_key, server_cert, and project keys.
  • Typed Status enum — sandbox.Status replaces raw strings for container state.

Breaking Changes

  • Removed CLI flags --host, --api-key, and -u/--username. These were TrueNAS-specific and are now set via config file or environment variables (PIXELS_TRUENAS_HOST, PIXELS_TRUENAS_API_KEY, PIXELS_TRUENAS_USERNAME).
  • Removed disk cache (~/.cache/pixels/). The sandbox backends query live state directly. The internal/cache package has been deleted.

Bug Fixes

  • Console zmx command, provisioning executor, and start IP polling.
  • TrueNAS exec respects Root flag and re-authorizes SSH key on auth failure.
  • Incus exec runs as configured user with proper shell wrapping and WebSocket IO.
  • Network egress setup no longer fails on dpkg conffile prompts.
  • Exec runs commands in a login shell with mise activation.

Full Changelog

v0.4.0...v0.5.0