Get started
Sign in
Passwords and realms, two-factor authentication, API tokens, OpenID Connect, and how Moxie Prox keeps your secrets.
Choose a way to sign in
Username & Password. Type the user name with its realm, for example root@pam or alice@pve. Leave Password (optional) empty to be asked each time; two-factor codes are requested when they’re needed.
API Token. Enter the Token ID (user@pve!tokenname) and the Token secret. Tokens are the best choice for everyday use: they can carry fewer permissions than the user they belong to, and you can revoke one without changing a password. Consoles work with a token too, as long as it has the VM.Console permission (guests) or Sys.Console (a host’s shell).
OpenID Connect. Enter the OpenID realm’s name. You sign in at the realm’s identity provider in a secure browser sheet, and Moxie Prox stores nothing from it. Your provider’s client must allow the redirect address moxieprox://openid.
Two-factor authentication
When your Proxmox user has two-factor authentication, Moxie Prox asks for it after the password. It supports:
- Authenticator code (TOTP), from an app such as Apple Passwords or another authenticator.
- Yubico OTP: touch your YubiKey.
- Recovery key.
Security keys and passkeys (WebAuthn) can’t be used from the app, because Apple allows them only for websites that list the app. Sign in once with Proxmox’s web page and add an authenticator app or recovery keys there.
Where your secrets live
- Token secrets, and passwords you choose to keep, are stored in your Mac’s Keychain. In the sign-in sheet, Remember in Keychain decides whether a typed password is kept.
- In Settings › Security, Require Touch ID to use saved passwords protects them with Touch ID.
- Sign-in tickets and two-factor codes stay in memory and are never written to disk.
Sign-in fields work with Password AutoFill, so Apple Passwords and other AutoFill providers can fill them.
Sign out
The Account menu has Sign In to “Home lab” and Sign Out of “Home lab” for the cluster on screen (the toolbar’s cluster list has them for every cluster), Forget Saved Password… (or Forget Saved Token Secret…), Sign Out of All Clusters and Lock Moxie Prox. A signed-out cluster says so where its pages were, with a Sign In button.
Change your password
Choose Datacenter › Permissions › Users, then My Password…, to change your Proxmox user’s password without opening the web interface.
Checked against Moxie Prox 1.3. Updated November 9, 2026.