clevis-luks-unlockers.7.adoc 2.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. CLEVIS-LUKS-UNLOCKERS(7)
  2. ========================
  3. :doctype: manpage
  4. == NAME
  5. clevis-luks-unlockers - Overview of clevis luks unlockers
  6. == OVERVIEW
  7. Clevis provides unlockers for LUKS volumes which can use LUKS policy:
  8. * clevis-luks-unlock - Unlocks manually using the command line.
  9. * dracut - Unlocks automatically during early boot.
  10. * systemd - Unlocks automatically during late boot.
  11. * udisks2 - Unlocks automatically in a GNOME desktop session.
  12. Once a LUKS volume is bound using *clevis luks bind*, it can be unlocked using
  13. any of the above unlockers without using a password.
  14. == MANUAL UNLOCKING
  15. You can unlock a LUKS volume manually using the following command:
  16. $ sudo clevis luks unlock -d /dev/sda
  17. For more information, see link:clevis-luks-unlock.1.adoc[*clevis-luks-unlock*(1)].
  18. == EARLY BOOT UNLOCKING
  19. If Clevis integration does not already ship in your initramfs, you may need to
  20. rebuild your initramfs with this command:
  21. $ sudo dracut -f
  22. Once Clevis is integrated into your initramfs, a simple reboot should unlock
  23. your root volume. Note, however, that early boot integration only works for the
  24. root volume. Non-root volumes should use the late boot unlocker.
  25. Dracut will bring up your network using DHCP by default. If you need to specify
  26. additional network parameters, such as static IP configuration, please consult
  27. the dracut documentation.
  28. == LATE BOOT UNLOCKING
  29. You can enable late boot unlocking by executing the following command:
  30. $ sudo systemctl enable clevis-luks-askpass.path
  31. After a reboot, Clevis will attempt to unlock all *_netdev* devices listed in
  32. */etc/crypttab* when systemd prompts for their passwords. This implies that
  33. systemd support for *_netdev* is required.
  34. == DESKTOP UNLOCKING
  35. When the udisks2 unlocker is installed, your GNOME desktop session should
  36. unlock LUKS removable devices configured with Clevis automatically. You may
  37. need to restart your desktop session after installation for the unlocker to be
  38. loaded.
  39. == SEE ALSO
  40. link:clevis-luks-unlock.1.adoc[*clevis-luks-unlock*(1)]
  41. link:clevis-luks-bind.1.adoc[*clevis-luks-bind*(1)]