Sign in Talk to us Free trial
Free trial

Design and software studio
Colour

Owner account, recovery key and authenticator app

Create the owner account, save the recovery key shown once, and set up the authenticator app that gives the six-digit sign-in code.

For
Owner
Hosting
Any hosting
Devices
Web browser
Business
All businesses

Checked against Pop Street Dispatch 0.1.0

The Owner account step creates the account that can see and change everything. It then shows a recovery key, which opens your data if the key stored on this computer is ever lost, and it sets up an authenticator app for the six-digit code you type at each sign-in. Passkeys arrive in a later version. Once the owner account exists, setup closes to anyone who is signed out.

Before you start #

Have your name and your email address ready. Choose a password of at least 10 characters. Have an authenticator app installed on your phone.

Steps #

The Owner account step with the name, email, password and repeat password boxes and the Create account button.
Steps 1 and 2: your details, then Create account.
The Save your recovery key step showing the key, the Copy the key and Save as a file buttons, and the box to confirm that the key is saved.
Steps 3 and 4: the recovery key appears once.
The authenticator step showing the QR code, the key to type into the app, the six-digit code box and the Check the code button.
Steps 5 and 6: scan the picture, then type the code.
  1. Type your Your name, Email, and Password. Type the same password again in Type the password again.
  2. Select Create account. The page shows "Owner account created."
  3. Under "Save your recovery key", the key appears once. Select Copy the key or Save as a file. Store the key somewhere away from this computer.
  4. Confirm with I saved the recovery key once the key is stored.
  5. Under "Set up the authenticator app", open the authenticator app on your phone and scan the QR code picture. If you cannot scan the picture, type the key shown under Or type this key into the app.
  6. Type the six-digit code the app shows into Six-digit code, then select Check the code. The page shows "Authenticator app is on."
  7. Continue to What you run.
Technical details
  • The password is stored with argon2id, a password hashing method.
  • The recovery key is shown once. Store it safely. The Vault and recovery key article explains how it is used.
  • The QR code and the typed key hold the same authenticator secret. Either one sets up the same app entry.
  • After the owner account exists, setup asks anyone who is signed out to sign in as the owner first. Answers given so far stay saved.
  • Passkeys come in a later version. The authenticator app is the second step for owners.

If something goes wrong #

  • The two passwords differ. The page says "The two passwords are different." Type the same password in both boxes.
  • The password is too short. Use at least 10 characters.
  • The code is refused. Type the code the app shows at that moment, without spaces. If it still fails, check that the phone's date and time are set automatically.
  • The recovery key is lost before it is saved. Read the Vault and recovery key article before you continue with setup.