Skip to content

Home

Jump to bottom
Rex Ackermann edited this page Dec 7, 2025 · 2 revisions

Welcome to the Linux Hello Wiki!

Linux Hello brings Windows Hello™-style facial authentication to Linux using standard IR or RGB cameras. It features rotation-invariant detection, secure TPM key storage, and a user-friendly GUI.

🚀 Key Features

  • Face Authentication: Login with your face anywhere sudo or GDM asks for a password (experimental PAM support).
  • Rotation Invariant: Works even if your device (tablet/laptop) is rotated 90°, 180°, or 270°.
  • Secure Storage: Uses TPM 2.0 (Trusted Platform Module) to securely store encryption keys, falling back to encrypted file storage if unavailable.
  • GUI Management: Complete graphical interface for enrolling users, managing samples, and testing the camera.
  • Bash Integration: Easily integrate face authentication into your own shell scripts.
  • Continuous Monitoring: "Walk-away lock" feature automatically locks your session when you leave.

📚 Documentation Sections

  • Installation: How to install, update, and uninstall.
  • User Guide: How to enroll, authenticate, and manage users via CLI or GUI.
  • Configuration: Detailed guide to config.yaml authenticaton levels, and camera settings.
  • Security: Deep dive into TPM integration, encryption, and security modes (Fast/Balanced/Secure).
  • Integrations: Using Linux Hello with Bash, PAM, and D-Bus.
  • Troubleshooting: Common issues, known bugs, and FAQ.

Made with ❤️ for the Linux Community

Clone this wiki locally