github doug445/AsahiLocker v1.0.0
v1.0.0 — Fedora Asahi LUKS2 root encryption

latest releases: v3.0.0, v2.2.1, v2.2.0...
3 months ago

Encrypt the root filesystem of an already-installed Fedora Asahi Remix system on Apple Silicon — in place, without reinstalling and without a second copy of your data.

Works on every M-series Mac that Asahi supports (M1 / M1 Pro / Max / Ultra, M2, M3, M4). Partitions, subvolumes and boot layout are all auto-detected at runtime, so nothing here is model-specific.

What's included

  • bin/luks-deploy.sh — wraps the existing btrfs root in a LUKS2 container from a live USB, preserving the btrfs UUID, subvolumes and data. Rewrites crypttab, fstab, /etc/kernel/cmdline, GRUB defaults, every BLS entry and dracut config, rebuilds all initramfs images, and refuses to declare success until a 10-point verification gate passes.
  • bin/post-encryption-setup.sh + save-luks-recovery-bundle.sh — recovery bundle, snapper subvolumes on the encrypted volume, boot-guard enablement, verification. Idempotent.
  • boot-guards/ — ESP stub guard (stops a stray grub2-mkconfig from dropping an encrypted box into a GRUB rescue prompt) and a cleaner for the stale EFI entries U-Boot leaves behind for unplugged installer USBs.
  • extras/ — optional luks-fetch-cache encryption-status readout for fastfetch.
  • docs/ — live-USB creation, step-by-step install with every prompt explained, recovery, U-Boot bootflow, internals, and fleet deployment.

Crypto

argon2id (4 GiB, t=10, p=4), sha512, aes-xts-plain64 with a 512-bit key. Pinned explicitly rather than left to cryptsetup's machine-dependent auto-benchmark, with LUKS_PBKDF_* overrides for lower-RAM machines.

Before you run it

This rewrites a live root filesystem. Read docs/INSTALL.md first, have a verified backup, and be on AC power. There is no TPM on Apple Silicon and therefore no recovery key — forget the passphrase and the data is gone.

Don't miss a new AsahiLocker release

NewReleases is sending notifications on new releases.