On the KEY · 5 minCreate your wallet
Plug in with USB-C (any 5 V charger) and hold a button to wake it. The first screen walks you through the four buttons, then asks how you want to start. Everything in this step happens on the KEY, with its radio off. Your words never touch the phone.
- KEYChoose NEW WALLET (or RESTORE if you already have 12 or 24 words).The KEY makes a new seed from two independent hardware sources (the secure element and the camera, both shown on screen), or from your own dice rolls if you choose. Nothing about it leaves the device.
- KEYSet two PINs: NOSTR and BTC.Two codes, two doors. The Nostr PIN unlocks your online identity; the Bitcoin PIN opens the air-gapped wallet. Keep them different: unlocking one never unlocks the other. From now on every power-on asks which door you want. Choose NOSTR for the rest of this guide.
- KEYWrite the 24 words on paper, in order. Not in your phone, not in a photo.The KEY then checks a few words back with you. It won't let you continue until the backup is right. If you slip, pick Show words again.
Phone + KEY · 1 minCheck it's genuine
Before you trust it with anything, make it prove it is a real Favilla KEY. Your phone generates a fresh challenge; the KEY signs it with a key sealed into its secure element at the factory; your phone checks the signature against our public list. Nothing is sent to us.
- PHONEOpen favillakey.io/verify and tap Start verification. A QR appears.
- KEYFrom the main menu choose SCAN and point the camera at your phone.The KEY reads the challenge, signs it, and shows its reply as a QR.
- PHONETap Scan KEY's reply and point the phone at the KEY's screen.You want Genuine. Anything else, stop and get in touch.
- KEYPress BACK to leave the result and return to the menu.You can do this check before typing any PIN, too: on a PIN screen, hold ENTER and BACK together.
KEY + phone · 2 minGet it online
The KEY and your phone talk over Wi-Fi. Out of the box the KEY has no network saved, so it starts its own short-range hotspot and shows you how to join. You can stop there, or give it your home Wi-Fi so both devices sit on the same network.
- KEYLook for the Wi-Fi QR on screen. The network is called
FavillaKey-XXXX.Not showing? Settings › NETWORK › WiFi networks. - PHONEScan the Wi-Fi QR with your camera app and join the network.Your phone will say "no internet" on this network. That is expected; the KEY is not a router.
- PHONEA setup page pops up (or open
http://192.168.4.1). Pick your home Wi-Fi and enter its password, or skip it.With a saved network the KEY joins it on every boot and your phone can go back to normal Wi-Fi. Without one it keeps using the hotspot, which is fine for a desk, a few metres of range on purpose.
KEY + phone · 3 minPair your phone
The KEY serves its own app to your phone. No App Store, nothing to download, no account. Pairing binds that one phone to this one KEY over an encrypted channel, and the KEY walks you through it on screen. Follow the KEY; this is the script.
- KEYMain menu › NOSTR › LOCAL. A QR with the app's address appears.
- PHONEScan it with your camera app. The Favilla app opens in your browser.iPhone: use Safari. Android: Chrome.
- PHONEAdd it to your home screen while the KEY asks you to.iPhone: Share ⍐ › Add to Home Screen. Android: menu ⋮ › Add to Home screen / Install app. Then open it from the new icon. Optional: the KEY carries on when you press ENTER either way.
- KEYPress ENTER. The KEY's camera opens.
- PHONEThe app shows a pairing code as a QR. Hold it up to the KEY.If the pair screen isn't already open, tap KEY at the top of the app, then Connect.
- BOTHBoth screens show the same short code. Check they match, then confirm on the KEY with ENTER.Different codes mean something between the two devices is interfering. Press BACK and start the step again.
- PHONEEnter your Nostr PIN when the app asks. Your feed starts loading.The PIN is checked by the KEY, not stored on the phone. The app forgets the session when the KEY locks.
KEY + phone · 2 minConnect other apps
Your phone is paired for the local app. For everything else (Amethyst, Damus, Coracle, the web) the KEY acts as a remote signer (a "bunker"): apps send it things to sign over Nostr relays, and the KEY signs or asks you first. Your key never leaves the device.
- KEYMain menu › NOSTR › REMOTE.The KEY connects to its relays and shows a QR. Leave this page open: it is the signing screen, and it stays here while apps are connected.
Our web client
Scan the first QR with your camera app. It opens favillakey.io/bunker with the connection filled in. Add it to your home screen too. It works anywhere you have internet, not just on your Wi-Fi.
Any other Nostr app
In the Favilla app on your phone: Profile › Connect another app › Pair a new app. Name it, tap Create, and show the QR to the other app's Login with bunker / remote signer. Each app gets its own link; revoke one later from the same list without touching the rest.
- KEYApprove the first request on the KEY with ENTER when it asks.Settings › SIGNING decides which kinds of events the KEY signs on its own and which always wait for you. The REMOTE page shows every signature as it happens, and keeps a history.
You're setWhat to know from here
Your KEY is signing.
Your keys are sealed by the secure element and used only on the vault processor, your paper backup is the only copy of the seed, and every app that can ask for a signature is one you named. A few things worth reading next: