Skip to content
Weik.ioDocs
2026.2
Try Weik.io

Two-factor sign-in

Weik.io 2026.2

Platform administrators and break-glass accounts give a code from an authenticator app at every local sign-in. Ten recovery codes cover a lost phone.

On this page

Two-factor sign-in is on from the first start. Platform administrators and break-glass accounts that sign in with a local password give a six-digit code from an authenticator app after the password. People who sign in through Microsoft Entra ID or another OpenID Connect provider use the provider’s second factor.

Enrol an authenticator app#

You enrol an authenticator app at the first sign-in that needs a code:

  1. Add the setup code that the admin UI shows to the authenticator app.
  2. Enter the six-digit code that the app shows, which changes every 30 seconds. Your first valid code confirms the enrolment.

The admin UI then shows ten recovery codes, once. Each code signs you in once if you lose the authenticator app. Keep the codes apart from Weik.io, as you keep the master key.

The first local admin enrols this way when they open the set-password link that init printed.

Codes and lockout#

A person who has enrolled an app gives its code even while the rule that requires two-factor sign-in is off.

Five wrong codes within 15 minutes lock the account from every address for 15 minutes. Wrong passwords lock out only the address they came from, as Local sign-in describes.

Turn it off for a sandbox#

Turn the rule off for an installation where administrators can’t use an authenticator app, such as a local sandbox:

Terminal
$ weikio settings set --two-factor-required=false --reason "local sandbox without authenticator apps"

While the rule is off, weikio problems lists the warning two-factor-off for platform administrators.

--two-factor-required=true turns the rule back on. Weik.io audits the change with its reason, like every change of the installation’s settings.

In the admin UI, you set the rule to Required or Off in Edit installation settings.

A settings document that leaves the field out, such as an old export, turns the requirement back on when you apply it with weikio apply -f.

Reset a lost authenticator#

When a person loses their phone and their recovery codes, another platform administrator clears their authenticator app:

Terminal
$ weikio user reset-totp anna.virtanen@example.com

The person enrols a new app at their next sign-in. A platform administrator can’t clear their own, so keep at least two platform administrators.

Sign in to the live demo

Sign in with the shared viewer account. It can open every screen of the example projects but can't change anything.

E-mail
viewer@demo.weik.io
Password
try-weikio-live-demo
Open the live demo