rwanyoike / mkinitcpio-remote-cryptroot

🔐 A systemd init (systemd hook) based implementation for booting a LUKS-encrypted system remotely

mkinitcpio-remote-cryptroot

systemd-networkd + tinysshd + systemd-tty-ask-password-agent

[Arch Linux] If you want to be able to boot a fully LUKS-encrypted system remotely, you will need a way to enter a passphrase for the root partition/volume at startup. This can be achieved by running a set of mkinitcpio hooks that configure a network interface, ssh access, and a password agent in initramfs.

$ ssh root@<remote host>
🔐 Please enter passphrase for disk cryptroot: (press TAB for no echo)

Works as of systemd 245 (245.6-7-arch)

Example

Example /etc/mkinitcpio.conf:

...
HOOKS=(base autodetect modconf block filesystems keyboard fsck systemd sd-encrypt network tinyssh password-agent)
...

Hooks

systemd (owned by the systemd package)

See: https://wiki.archlinux.org/index.php/Mkinitcpio#Common_hooks

This hook triggers a systemd based init, which does not run any runtime hooks but uses systemd units instead.

sd-encrypt (owned by the cryptsetup package)

See: https://wiki.archlinux.org/index.php/Mkinitcpio#Common_hooks

This hook allows for an encrypted root device with systemd initramfs.

Recommend: That you set a root device timeout kernel parameter:

rootflags=x-systemd.device-timeout=0

network

This hook sets up the systemd-networkd.service systemd service and copies over any *.initramfs files in /etc/systemd/network.

Example:

# /etc/systemd/network/wired.network.initramfs

[Match]
Name=*

[Network]
DHCP=yes

tinyssh

This hook sets up the initrd-tinyssh.service systemd service, converts the openssh ed25519 host key to binary format for TinySSH, and copies over the authorized keys file at /etc/tinyssh/root_key.

Example:

# /etc/tinyssh/root_key

ssh-ed25519 <base64-encoded key> <comment>

password-agent

This hook adds the command systemd-tty-ask-password-agent --query to /root/.profile (for sh invocation).

License

This project is licensed under the MIT License.