Site Tools

New release candidate 2 available: rc2022-06-26 "Igor". upgrade now! [52.1] (what's this?)
New release candidate available: 2022-06-26 "Igor". upgrade now! [52] (what's this?)

Prepare base image

pacman -S arch-install-scripts
btrfs subvol create /var/lib/container/archlinux-base
mkdir /etc/systemd/nspawn
pacstrap /var/lib/container/archlinux-base base
systemctl enable --now systemd-networkd systemd-resolved

Prepare child image

Setting UID range for container: Using a multiple of 65536, e.g. 65536 * 70 for this machine as. To match the user http (always uid 33) on the container, a user on the host with the same permissions should therefore have the UID: 65536 * 70 + 33.

useradd -m -u $((65536 * 70 + 33)) archlinux-dokuwiki
mkdir /home/archlinux-dokuwiki/data
chown -R archlinux-dokuwiki:archlinux-dokuwiki /home/archlinux-dokuwiki/data

PrivateUsers parameter is here equal to 65536 * 70

systemd-nspawn -nD /var/lib/machines/archlinux-dokuwiki --template=/var/lib/container/archlinux-base --private-users-chown --private-users=4587520 --boot &
pacman -S ansible
wget "" -O /usr/lib/python2.7/site-packages/ansible/plugins/connection/
machinectl shell root@archlinux-dokuwiki /bin/bash -c "systemctl enable --now systemd-networkd systemd-resolved" 
machinectl shell root@archlinux-dokuwiki /bin/bash -c "pacman -Sy python2 --noconfirm"
git clone ...
cd ...
ansible-galaxy install -r requirements.yml
sudo -E ansible-playbook -c machinectl -i inventory -v archlinux-dokuwiki.yml

After bootstrapping we can enable our mount:



machinectl terminate archlinux-dokuwiki
systemctl enable systemd-nspawn@archlinux-dokuwiki.service
systemctl restart systemd-nspawn@archlinux-dokuwiki


Reset child

systemctl stop systemd-nspawn@archlinux-dokuwiki
btrfs subvolume delete /var/lib/machines/archlinux-dokuwiki/var/lib/machines 
btrfs subvolume delete /var/lib/machines/archlinux-dokuwiki


  • auto update base image, auto reboot childs
  • private ethernet
  • bind data


#pid        {{ nginx_pidfile }};
  • machine not starting automatically (systemctl enable systemd-nspawn@machine-dokuwiki)


Iptables forward host port to container

iptables -t nat -A PREROUTING -i ens3 -p tcp --dport 80 -j DNAT --to 

Container ip and port can be checked with nmap

nmap -p 80 archlinux-dokuwiki
systemd-nspawn.txt · Last modified: 2021/10/31 10:42 by