Help & Reference

Passkeys

A passkey is an optional, faster sign-in for mirepoix. This page explains what one is, why mirepoix offers them, and what happens when you lose a device that holds one.

What a passkey is

A passkey is a credential your device generates and stores for one site — for mirepoix, the domain you sign in on. (The hosted service is mirepoix.recipes; a self-hosted instance uses its own domain.) There are two halves: a private half your device keeps and never shares, and a public half mirepoix stores against your account.

When you sign in, the browser asks your device to prove it still holds the private half. You unlock that proof the same way you unlock your device — Face ID, Touch ID, Windows Hello, an Android lock screen, a security key, a PIN. mirepoix only sees the proof; the private half never leaves your device.

A passkey isn’t a password. There’s nothing to type, nothing to remember, and nothing for an attacker to phish: the proof only works on the mirepoix site you registered it on, from a device that holds the right private half.

Where passkeys live

Modern operating systems and password managers store and sync your passkeys for you. The same passkey usually appears on every device signed into the same platform account:

Whatever you already use to remember your accounts is where mirepoix’s passkey lives.

Why mirepoix offers them

mirepoix has no passwords. There’s no password to set, no password to forget, no password to phish. Sign-in is by 8-character code emailed to you (see Signing in) — universal, but it takes a trip to your inbox each time you sign in on a fresh device.

A passkey skips that trip. Add one from Settings → Passkeys; the sign-in page then offers Sign in with a passkey next to Send me a sign-in code. Both buttons land you on the same account.

Passkeys are an option, not a requirement. The email-code path stays available on every device, even ones that never registered a passkey.

What this means in practice

See also