How to sign in to Actual
Actual uses two keys: your password and a 6-digit code from an authenticator app on your phone. This guide shows how to set it up once, then how to sign in every day.
What you need
- Your user ID or e-mail, and the password from your office’s System Admin.
- A phone with an authenticator app. The apps are free and show codes without an internet connection.
Install an authenticator app
Install one of these apps from Google Play or the App Store. They all use the same time-based code standard (TOTP), so pick the one you like.
Google Authenticator
Android and iPhone
Microsoft Authenticator
Android and iPhone
2FAS or Authy
Android and iPhone
Password managers
1Password, Bitwarden or the built-in iPhone Passwords app (iOS 18 and later) can also keep the codes
First sign-in (once only)
- 1Open the Actual sign-in page. The interface language can be switched with EN | ID at the top right.
- 2Enter your user ID or e-mail and the password from the System Admin, then click Sign in.
- 3If asked, create a new password of at least 12 characters, then click Save password.
- 4The two-step verification screen shows a QR code. In the authenticator app, add an account (the + sign), choose scan a QR code, and point the camera at the screen.
- 5Cannot scan? In the app, choose enter a setup key and type the key written under the QR. Any account name will do, for example Actual; the type is time-based.
- 6The app now shows 6 digits for Actual that change every 30 seconds. Type them into the 6-digit code field, then click Activate.
- 7Keep the recovery codes that appear somewhere safe, for example printed or in a password manager, then click I have saved them.
Signing in every day
- 1Enter your user ID or e-mail and password, then click Sign in.
- 2Open the authenticator app, read the 6 digits for Actual, type them into the 6-digit code field, then click Verify.
- 3A code works once. If the digits are about to change, wait for the next ones.
New phone or lost phone
- New phone: before you give up the old phone, move the account inside the authenticator app (in Google Authenticator: Transfer accounts). Or ask the System Admin to reset two-step verification and scan a new QR at your next sign-in.
- Lost phone: on the code screen, click Use a recovery code and type one of your recovery codes. Each works once. After signing in, ask the System Admin to reset two-step verification.
Common problems
- The code is always refused
- Make sure the phone’s date and time are set automatically. Codes come from the phone’s clock, so a clock a few minutes off gives wrong codes.
- The account is locked
- Five wrong passwords lock the account for 15 minutes. Wait, then try again.
- Forgot the password
- Click Forgot password? on the sign-in page, or ask the System Admin to reset your password.
- No code by SMS or e-mail
- Actual never sends codes by SMS or e-mail. The code always comes from the authenticator app on your phone.
Never share your password, 6-digit codes or recovery codes with anyone, including someone claiming to be from IT. The System Admin never asks for your code.
The full guide to every module is in the Guide menu after you sign in.
Back to sign-in