Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Supported systems

Tested on Arch with Podman 6.1 and systemd 261. Every version is tested there before it is tagged; see Test runs.

The least that install accepts

install checks each of these before it changes anything, and names the version it found and the one it needs. No flag gets around them.

  • Linux, on a machine you have an ordinary account on. sandcastle never runs as root.
  • Podman 6.0.0, rootless, with the netavark 2.0.0 network backend and pasta.
  • systemd 252, with a user manager for your account.
  • A range for your account in /etc/subuid and in /etc/subgid.
  • The cpu, memory and pids cgroup controllers delegated to your user.
  • Two free IPv4 /24 ranges for the installation’s networks; see Network names and ranges.

install also uses ip and loginctl. Troubleshoot says how to fix what it refuses.

To build

Go, at the version in go.mod, and Git. The binary must be built with CGO_ENABLED=0. It can be built on another machine, with GOOS=linux and the GOARCH of the machine that runs it, and copied there.