Account Recovery
Reset an administrator password or clear passkey MFA from inside the Arcane container when nobody can sign in.
These commands update the database inside the Arcane container without starting the HTTP server. Both end the user’s sessions immediately, including cached sessions on other Arcane instances.
Reset an administrator password
Section titled “Reset an administrator password”-
Add
ARCANE_ALLOW_CLI_PASSWORD_RESET=trueto Arcane’s environment and recreate the container. -
Run the command:
Terminal window docker exec -it arcane arcane admin reset-passwordIt resets the user
arcane. For another admin, add--username alice. -
Enter the new password twice. Input is hidden.
-
Remove the variable and recreate the container again.
On success it prints Password reset successfully for global administrator "<username>" and revokes all that user’s sessions. It also clears a pending required password change, such as the one on the default arcane account.
- Only accounts with global administrator permissions can be reset. An unknown name returns
global administrator "<name>" not found. - The new password must meet the password policy.
Clear passkey MFA
Section titled “Clear passkey MFA”Use this when an MFA account has lost its passkey and recovery codes, or an OIDC-only account has no password and no passkey on the current browser. It works on any account, not only administrators.
-
Add
ARCANE_ALLOW_CLI_MFA_RESET=trueto Arcane’s environment and recreate the container. -
Run the command (
--usernamedefaults toarcane):Terminal window docker exec -it arcane arcane admin reset-mfa --username alice -
Type
RESETexactly when prompted. -
Remove the variable and recreate the container again.
This disables passkey MFA, deletes recovery codes, cancels any pending MFA transaction, and revokes the user’s sessions. Registered passkeys stay, so the user can sign in with a password or OIDC and turn MFA back on. See Passkeys & MFA.
Why the commands are off by default
Section titled “Why the commands are off by default”Both commands grant administrator access, so each needs its own variable. Turn it on only while you use it.
| Command | Turned on by |
|---|---|
arcane admin reset-password |
ARCANE_ALLOW_CLI_PASSWORD_RESET=true |
arcane admin reset-mfa |
ARCANE_ALLOW_CLI_MFA_RESET=true |
Without the variable, the command refuses:
CLI password reset is disabled; set ARCANE_ALLOW_CLI_PASSWORD_RESET=true to enable itRequired password change
Section titled “Required password change”The default arcane account must change its password at first sign-in. Until it does, the server answers every signed-in request except reading the current user, loading the session, changing the password, and signing out with 403 password change required. Changing the password or running arcane admin reset-password clears the requirement.
Password policy
Section titled “Password policy”System → Authentication → Password Policy applies to every password creation and change, including arcane admin reset-password.
| Setting | Default | Requirement |
|---|---|---|
| Minimum Length | 12 |
Shortest allowed password, from 8 to 128 characters. |
| Require Uppercase Letter | On | At least one uppercase letter. |
| Require Lowercase Letter | On | At least one lowercase letter. |
| Require Number | On | At least one number. |
| Require Symbol | On | At least one symbol. A space counts as a symbol. |
Rejected passwords show the current requirements. An unreadable or invalid setting falls back to its default.
Upgrading from the earlier basic, standard, and strong presets keeps the same requirements:
| Preset | Minimum Length | Uppercase | Lowercase | Number | Symbol |
|---|---|---|---|---|---|
basic |
8 |
Off | Off | Off | Off |
standard |
10 |
On | On | On | Off |
strong |
12 |
On | On | On | On |