SETUP_TOKEN secret you chose when you deployed.
Create the owner account
1
Open the desk
Open your Worker’s URL. A fresh desk shows Set up your desk.Use the hostname you’ll keep using. Passkeys only work on the hostname they were created on; see Custom domain if you plan to move.
2
Fill in the form
- Setup token: the
SETUP_TOKENyou chose when deploying. - Workspace name: your company or team, such as “Acme Support”.
- Your name and Email: for your account. No email is sent.
3
Create the passkey
Press Create passkey and finish setup and confirm in your browser’s prompt. The desk creates the workspace, your owner account, the website inbox with its widget key, and your first passkey in one step, then signs you in and opens Get started.
If you see “SETUP_TOKEN isn’t configured”, the secret is missing or shorter than 16 characters. Set it with
npx wrangler secret put SETUP_TOKEN, or in the Cloudflare dashboard under the Worker’s Settings → Variables and Secrets, and try again.Sign in
On a desk that’s set up, signed-out visitors see Sign in. Press Sign in with passkey and pick your passkey. You don’t type a username: the passkey says who you are. A sign-in lasts 30 days in that browser.Add more passkeys
Add a passkey on a second device so losing one phone or laptop doesn’t lock you out.1
Open Passkeys
Open the account menu at the bottom of the sidebar, choose Settings, then Passkeys.
2
Add one
Press Add passkey and complete the browser’s prompt. To add one for another device, run this on that device after signing in there, or choose the browser’s option to use a phone or security key.
Recover owner access
If the owner has lost every passkey, the setup token lets you add a new one.1
Open /recover
Go to
https://<your-desk>/recover, or press Recover with the setup token on the sign-in page.2
Enter the setup token
Enter the
SETUP_TOKEN and press Add a new passkey. The new passkey is added to the first owner account, and you’re signed in.Sign out
Open the account menu at the bottom of the sidebar and choose Sign out. It ends the session in that browser.Add your team
Teammates don’t use the setup token. An owner or admin creates an invite link in Settings → Team (or in the last Get started step). The teammate opens it, enters their name and email, and presses Create passkey and join. Each link works once, for 7 days. Owners can invite admins and agents; admins can invite agents. See Team.Get started checklist
The six steps after your first sign-in.
Custom domain
Move the desk, and your passkeys, to your own hostname.