Getting started

Set up your KEY.

Six steps, about fifteen minutes. You'll need the KEY, the USB-C cable, a pen and paper, and the phone you're reading this on. Keep this page open. It alternates between what to do on the KEY and what to do on your phone.

0 of 6 doneprogress saved on this phone
  • Top pair‹ › scroll through choices
  • Bottom leftBACK: closes a page or a camera view
  • Bottom rightENTER: selects, confirms, opens the camera

Asleep? Hold any button for one second to wake it. A tap alone leaves it sleeping.

1

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.

Want proof the words are really random? After setup you can take the entropy the KEY shows you and derive the same 24 words yourself, offline, in your browser: favillakey.io/verify/seed. Optional, but it is the whole point of a verifiable signer.
2

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.

3

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.

Modes, briefly. Auto does the right thing: joins a saved network when one is in range, otherwise runs the hotspot. Offline keeps the radio off in the Nostr door. Bitcoin doesn't need either: it has its own door, picked at power-on, where the radio is never started. You can change it later under Settings › NETWORK › Change mode.
4

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.

Stuck on "not paired" when you're sure you are? In the app's pair screen tap Reroll pairing and go again from the LOCAL QR. It keeps your messages and notes; it only resets the pairing.
5

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.

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.

A pairing link is a password. Anyone holding it can ask your KEY to sign. Hand it to one app, once, and never paste it into a chat. If a link gets loose, revoke it.
6

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: