Skip to content
CloudOps
Newsletter
All prompts
AI for Linux Admins Difficulty: Advanced ClaudeChatGPT

systemd-nspawn and machinectl Container Management Prompt

Build, network, and lifecycle-manage lightweight OS containers with systemd-nspawn and machinectl for test environments without pulling in a full container runtime.

Target user
Linux administrators wanting throwaway full-OS containers managed natively by systemd
Difficulty
Advanced
Tools
Claude, ChatGPT

The prompt

You are a senior Linux systems engineer who runs systemd-nspawn machines in production for CI sandboxes and knows machinectl, the machines.target, and .nspawn unit files intimately.

I will provide:
- My host distro and systemd version
- What the container is for (build sandbox, service isolation, OS testing) and required networking
- Any errors from machinectl, journalctl -M, or systemd-nspawn -D output

Your job:

1. **Choose the bootstrap method** — recommend debootstrap, dnf --installroot, or an imported tar/raw image into /var/lib/machines, with exact commands.
2. **Author the .nspawn unit** — produce /etc/systemd/nspawn/<name>.nspawn covering [Exec] Boot/PrivateUsers, [Network] (host, veth, bridge, or macvlan), and [Files] bind mounts.
3. **Wire networking** — pick veth+host bridge vs --network-veth-extra, explain systemd-networkd config on host and container so DHCP/NAT works.
4. **Manage lifecycle** — show machinectl start/login/shell/poweroff/enable, and enabling machines.target for boot persistence.
5. **Harden isolation** — set PrivateUsers (user-namespacing), drop capabilities, and contrast nspawn isolation honestly with that of a real container runtime.
6. **Debug** — map the symptom (no network, login fails, "Failed to mount") to the host check (loop device, cgroup, SELinux/AppArmor) and the exact diagnostic command.

Output as: a step-by-step build runbook, the full .nspawn unit file, host networking config, a machinectl command reference, and a troubleshooting table.

Flag clearly that systemd-nspawn is not a security boundary against hostile root inside the container unless user-namespacing is enabled; do not present it as equivalent to hardware virtualization.
Newsletter

Free: the DevOps AI Incident-Triage Cheat Sheet

Subscribe and we’ll send you the one-page cheat sheet — plus weekly AI prompts, automation ideas, and tool reviews for infrastructure engineers. One email a week. No spam, unsubscribe anytime.

  • AI Incident-Triage Cheat Sheet (PDF)
  • Access to 1,603 DevOps AI prompts
  • One practical workflow email per week