sdme 0.6.8

The systemd machine editor
Documentation

sdme

sdme is a command line tool for managing systemd-nspawn containers on Linux. It is distributed as a single static binary or in packages (deb, rpm, pkg) for x86_64 and aarch64.

sdme configures and orchestrates systemd to run containers. Each container boots its own systemd init: services start, timers fire, journald collects logs. It works like a real machine. Containers use overlayfs copy-on-write layers, so each one gets its own writable filesystem on top of a shared base image, keeping the original intact.

As part of the toolkit, sdme imports root filesystems from multiple sources including OCI registries (e.g. Docker images), tarballs, directories, and QCOW2 images. It also deploys multi-container pods from Kubernetes Pod YAML manifests.

Why sdme?

  • Test real scenarios: systemd units, multi-service setups, distro packaging, upgrade paths. Anything that needs a booted system.
  • Clone your machine: sudo sdme new snapshots your root filesystem and drops you into a shell.
  • Any systemd distro: Ubuntu, Fedora, Arch, NixOS, openSUSE, CentOS, CachyOS, and more.
  • OCI application images: run Docker Hub images (nginx, redis, postgres) as systemd services.
  • Kubernetes Pod YAML: deploy multi-container pods with volumes, secrets, configmaps, and health probes.

Downloads, tutorials, and documentation

fiorix.github.io/sdme