Housekey¶

Motivation¶
Part of my efforts to architect a secure, self-hosted, fully passwordless computer setup.
Using housekey you can secure all your data with hardware keys. Mix and match the keys, add backup keys, enrol keys for friends, family, or colleagues to keep your data secure and recoverable - with no passwords involved. Housekey makes it simple and secure to manage, encrypt, and decrypt different types of data. Start by securing your many passwords in a KeePassXC database, then create shared encrypted folders, and finally encrypt entire disks.
What is a hardware key? It could be the security chip (TPM) in your computer, or an Android phone, an iPhone or iPad, or a FIDO2 token (such as a YubiKey). Some of these you already own, new ones can cost as little as $25 / £20.
Housekey handles encryption for vaults using LUKS, ZFS, KeePassXC, or gocryptfs; and the hardware keys can be your own computer's TPM, an Android phone, an iPhone or iPad, or a FIDO2 token.
No internet access needed; no cloud service; no account required with any provider; no privacy concerns; no AI tools reading your data. With Housekey you take ownership and responsibility for securing your own data.
How it works¶
A vault is unlocked by a hardware key that must verify the user on every use: a FIDO2 token (fingerprint or PIN), the machine's own TPM2 (PIN), an Android mobile running the housekey app (fingerprint or screen lock), or an iPad or iPhone running it (Touch ID, Face ID or its passcode; enrolled unattested, and only where the configuration allows it). Every vault should have at least two keys enrolled - three is better - and any enrolled key can be used to manage the vaults. The underlying passphrase is never typed and never stored.
For FIDO2 tokens, credentials are discoverable (resident): they live on the token, so unlocking costs exactly one verification with no wasted touches. Every key has an id recorded beside its wrap or keyslot, which names it and opens nothing: a token's is a hash of its credential's id, which the token gives up with no PIN and no touch, so housekey can say which vaults a key is on without asking it to verify. A TPM2 key's id is its public name, so housekey can tell whether this machine's TPM is enrolled without asking for its PIN. A mobile's key is made by the housekey app in the mobile's secure hardware (StrongBox, or the TEE) and never leaves it; housekey records a hash of its public key, so it knows which mobile is enrolled before asking it anything.
Getting Started¶
Install housekey and initialise it. Set up a key. Create an encrypted vault, or take over an existing one. See Getting started.