archlinux-initrd-ssh-cryptsetup/README.md

Personal ArchLinux package combining dropbear and cryptsetup in initrd for unlocking LUKS-encrypted devices either locally (boot console) or remotely over SSH.
The code was reworked from [dropbear_initrd_encrypt](https://aur.archlinux.org/packages/dropbear_initrd_encrypt/).


## Installation
After cloning the repo, installation is done as for an AUR package.


## Configuration
As explained upon installation, the following things need to be done:
  * add the SSH public key to `/etc/dropbear/initrd.authorized_keys`
  * add the `ip=` kernel command parameter to the bootloader configuration (see https://wiki.archlinux.org/index.php/Mkinitcpio#Using_net)
  * in the `HOOKS` section of `/etc/mkinitcpio.conf`, add `ssh-cryptsetup` before `filesystems`; then rebuild the initramfs: `mkinitcpio -p linux`

The LUKS-encrypted devices to unlock are derived from `/etc/crypttab`.


Some options can be set in `/etc/dropbear/initrd.env` (file is sourced in initrd shell):
  * `sshcs_opt_listen`: SSH listening port
    - default: 22
  * `sshcs_opt_timeout_poweroff`: time (in seconds) to unlock devices before automatic powering off
    - default (and minimum value): 2 minutes
    - negative value to deactivate

For example:

    sshcs_opt_listen=2222
    sshcs_opt_timeout_poweroff=-1