# Two-step sign-in

> A code from an authenticator app on top of your password — how to turn it on, recovery codes, and what it covers.

Source: https://livops.dev/en/docs/security

Two-step sign-in (2FA) asks for a 6-digit code from an authenticator app every time a new device signs in to your account. It is **off by default**; turn it on in the cabinet under **Account → Security**.

## Turn it on

1. Open **Account → Security** and press **Turn on** on the **Two-step sign-in** card.
2. Scan the QR code with an authenticator app — Google Authenticator, 1Password, Authy, Bitwarden and others all work. Can't scan? Type the key shown under the code.
3. Enter the 6-digit code the app shows, and press **Confirm**.
4. You get **10 recovery codes**. They are shown **only once** — copy them or download the `.txt` file and keep it somewhere safe. Livops stores only their hash.

## Signing in

After your password, Livops asks for the code from the app. The same applies to every way in:

- **GitHub / Google sign-in** — after the provider, the code is still asked.
- **Password reset** — a reset link proves the mailbox, not the phone; the code is still asked.
- Wrong codes count against the same lock as wrong passwords: after 3 wrong attempts the account is locked for 5 minutes from that address.

A device that has given the code stays signed in like any other session. You can sign devices out on the same Security page.

## Lost your phone

On the code screen press **Use a recovery code** and enter one of the ten. Each works once. With the codes you can then turn 2FA off, or make a new set with **New recovery codes** (the old set stops working at once).

## Turn it off

**Turn off** asks for your password **and** a current code from the app (or a recovery code). An account that signs in only through GitHub/Google is asked for the code alone.

## Security events

The Security page lists what happened to your account's protection: 2FA turned on or off, a recovery code used, new codes made. A recovery code you didn't use is a reason to change your password and sign other devices out.

## What it doesn't affect

[API tokens](https://livops.dev/en/docs/api-tokens) are separate credentials: the [CLI](https://livops.dev/en/docs/cli) (`livops login`), CI and scripts keep working without a code. Revoke a token if it leaks.
