Skip to content

canonical/snap-tpmctl

Repository files navigation

snap-tpmctl

snap-tpmctl is a command-line tool to manage TPM-backed Full Disk Encryption (FDE) on Ubuntu systems.

It provides a single operational interface for:

  • checking TPM/FDE status
  • creating and validating recovery keys
  • managing passphrase and PIN authentication methods
  • listing LUKS keyslots metadata
  • unlocking and mounting encrypted volumes

Why this project is useful

Managing TPM and FDE operations often involves multiple low-level tools and repetitive, error-prone steps.

snap-tpmctl centralizes these workflows into clear, auditable commands designed for administrators, support engineers, and automation scenarios.

Quick usage examples

Check current FDE status:

snap-tpmctl status

Create a recovery key:

sudo snap-tpmctl create-recovery-key my-recovery-key

Add PIN authentication:

sudo snap-tpmctl add-pin

List configured recovery keys:

snap-tpmctl list-recovery-keys

Unlock and mount an encrypted volume:

sudo snap-tpmctl mount-volume /dev/nvme0n1p4 /media/my-vol

Contributing

Contributions are welcome. Please read CONTRIBUTING.md for more info.

About

CLI tool for managing TPM-based full-disk encryption with snapd on Ubuntu systems

Resources

License

Contributing

Stars

Watchers

Forks

Contributors