Replies usually within 2 business days

Support

Autheris is a small, focused app, and support is answered by the person who builds it. Start with the answers below — most questions are one of these — and email if you are still stuck.

Getting started

How do I add an account?

Tap Add on the home screen, then scan the QR code the service shows you when enabling two-factor authentication. If you already have a setup link (otpauth://…), paste it in instead — or choose a screenshot of the QR code from your photo library. The account name is optional.

What are the system requirements?

iOS 16.0 or later on iPhone. Face ID or Touch ID requires the matching hardware; everything else works without it.

Does it work with no internet connection?

Yes — codes are generated entirely on device. The network is only used when you enable iCloud Sync or when the app looks up an issuer’s logo.

Codes that are rejected

A service says my code is wrong
  • Check the device clock. TOTP codes are time-based; if your iPhone’s time is more than about 30 seconds out, every code will be wrong. Settings → General → Date & Time → Set Automatically.
  • Check the algorithm. Autheris defaults to SHA-1, which is what nearly every service uses. A few require SHA-256 or SHA-512 — edit the account and change the algorithm; the preview code updates as you change it.
  • Check the digit count and period. Standard is 6 digits and 30 seconds. Some services use 7 or 8 digits.
  • Check the secret. If the account was added by hand, a mistyped character will produce valid-looking but wrong codes. Re-add it by scanning instead.
Two accounts produce the same code

They are almost certainly the same secret added twice — often one from a QR scan and one from an import. Delete the duplicate.

Locking and privacy

How do I turn on Face ID or Touch ID?

Settings → Security. Autheris locks when it opens and again 30 seconds after it is sent to the background. Those three privacy toggles — blur when backgrounded, hide codes in the app switcher, and hide codes while recording or mirroring — default to on.

My codes are hidden and I cannot read them

You are probably recording or mirroring your screen (Screen Recording, AirPlay or a connected Mac). Autheris covers codes during capture by design. Stop the recording or mirroring and the codes reappear.

Why are my codes still visible in a screenshot?

iOS gives apps no notification when a screenshot is taken, so the privacy screen cannot cover it. Autheris protects against the app switcher, backgrounding and screen capture, and does not claim to block screenshots. Treat any screenshot of your codes as exposed.

Backups, new devices and lost phones

How do I move Autheris to a new iPhone?

Two supported routes:

  • iCloud Sync — turn it on before switching, sign in to the same Apple ID on the new iPhone, install Autheris and turn sync on. Secrets are end-to-end encrypted by CloudKit.
  • Encrypted backup — Settings → Backup, create an AES-256-GCM backup with a password you choose, save it somewhere you control, then restore it on the new device.

Because tokens are stored in the Keychain with “this device only” protection, they do not travel with an iCloud or encrypted iTunes/Finder backup of the phone.

I forgot my backup password

There is no recovery — the file is encrypted with that password and nothing else. That is the point of the format, and why the password should go in a password manager when you create the backup.

Does reinstalling the app delete my codes?

No. Since 2.0, tokens, settings and deletion tombstones live in the Keychain, which survives deleting and reinstalling the app. A code you deleted also stays deleted across a reinstall.

iCloud Sync

The sync status says “Sync unavailable” or “Sign in to iCloud”
  • Sign in to iCloud — the device is not signed in to iCloud, or iCloud Drive is off for this Apple ID. Settings → [your name] → iCloud.
  • Sync unavailable — iCloud Sync cannot start, usually because the build or its CloudKit container is not configured for this device. Try again on a release build from the App Store.
  • Sync Paused — the device is offline. Local codes are always authoritative on screen; sync resumes when the network returns.
How do I delete my codes from iCloud?

Settings → iCloud Sync → Delete Tokens from iCloud. This removes them from your other devices too. If you only want to stop syncing on this iPhone, turn sync off and choose “keep the codes on this device”.

Why didn’t my drag-to-reorder change sync to my other iPhone?

Pins sync because a pin is a property of the code. The order you drag codes into is deliberately per device, like arranging home screen icons — otherwise a single drag would rewrite many records at once and could drop a concurrent edit on another device.

Importing from another authenticator

Which apps can I import from?

Google Authenticator, Aegis, andOTP and 2FAS export files, plus QR codes and setup links. Exports are usually a JSON file or a set of QR codes; Autheris reads both.

An import failed part-way through

Imports are per-file and additive — nothing already in your list is removed. Re-run the import with the same file; duplicates are easy to spot and delete.

Still stuck?

Email support@autheris.app with your iOS version, the Autheris version (Settings → About), and what you expected to happen. Screenshots help — but do not send a code or a setup key.

Bugs and feature requests are also welcome on GitHub. Security issues: email first, please, so a fix can ship before details are public.