Repository navigation
Two Factor Sign in
Courier can ask for a second step when you sign in: a six-digit code from an authenticator app on your phone (Microsoft Authenticator, Google Authenticator, Authy, 1Password and the like all work). It uses the same standard those apps use for every other site, so nothing extra is installed anywhere. It is per person, and optional unless an administrator requires it for everyone.
- Sign in, open General Settings -> Users, and find the Two-factor sign-in card.
- Press Set up two-factor sign-in. A QR code appears. Scan it with your authenticator app, or type the secret shown beside it into the app by hand.
- Enter the six-digit code the app now shows.
- Save the eight recovery codes shown next. They appear once. Any one of them signs you in if you lose your phone, and each works only once.
From then on, signing in asks for your password, then for the current code from the app (or one of your recovery codes). Wrong codes count toward the same one-minute wait as wrong passwords.
An administrator can tick Require two-factor sign-in for every account on General Settings -> Users. Anyone without two-factor then has to set it up the next time they sign in, before they can do anything else. Only an administrator who already has two-factor on their own account can switch this on, so the person who switches it on is never the first one shut out.
On the same card, enter your password and a current code (or a recovery code). Both are needed on purpose, so a sign-in left open on a desk cannot remove it. If two-factor is required for everyone, turning it off takes you straight back to setting it up again.
Use one of your recovery codes to sign in, then turn two-factor off and set it up again on the new phone. If you have no recovery codes left, another administrator can press Reset two-factor beside your name in the Users table; you then sign in with your password alone and set it up again.
If no administrator can sign in, run Courier.exe --setup-admin from an elevated prompt in the program folder on the server. After you type YES it makes another administrator without changing any existing account; sign in with it and reset the locked-out account from General Settings -> Users.
- Two-factor belongs to your own account, so you set it up while signed in as yourself.
- Codes depend on the phone's clock being roughly right (within about a minute). If codes are refused, check the phone's time is set automatically.
- The QR code is made on your Courier server; the secret never leaves it except to your phone.
Last updated: 2026-11-17 (0.7.4)