proton account
Your Proton account, its settings and your session.
Every command under proton account, with the arguments and flags it takes. For these commands in use, see the guide.
Holds get, login, logout, profiles, sessions and settings.
Show the account, its storage and this machine’s session.
proton account getproton account getproton account get --output jsonSign in and save the session for this profile.
Signing in also unlocks your keys, so your password is needed once per machine and not again. Anything a flag has not set is asked for, as long as this is a terminal.
Signing in again as the same account changes nothing, so an unattended job can run it first and recover from a session that expired.
proton account loginproton account loginproton account login --profile workproton account login --user me@proton.me --password-file /run/secrets/protonproton account login --user me@proton.me --password-stdin --totp 123456| Flag | Description |
|---|---|
--password-file string |
Read the account password from a file |
--password-stdin |
Read the account password from stdin |
--totp string |
Two-factor code |
--user string |
Proton account email to sign in as |
logout
Section titled “logout”Discard the saved session for this profile.
The sealed key password on disk is useless without the session, so removing the file is enough to make it unreadable. –revoke additionally invalidates the session at Proton, which is what signing out in a Proton app does.
proton account logoutproton account logoutproton account logout --revokeproton account logout --all| Flag | Description |
|---|---|
--all |
Act on everything in scope, rather than a subset |
--revoke |
Also invalidate the session at Proton |
profiles
Section titled “profiles”Accounts signed in on this machine.
Holds delete and list.
profiles delete
Section titled “profiles delete”Remove saved sessions by profile name.
proton account profiles delete REF...proton account profiles delete workprofiles list
Section titled “profiles list”List the profiles with a saved session.
proton account profiles listproton account profiles listsessions
Section titled “sessions”Sessions Proton holds for this account.
Holds list and revoke.
sessions list
Section titled “sessions list”List every signed-in session.
proton account sessions listproton account sessions listsessions revoke
Section titled “sessions revoke”Invalidate sessions at Proton.
A revoked session cannot decrypt the key password sealed into its saved file, so revoking is what makes a leaked session file worthless.
proton account sessions revoke [REF...]proton account sessions revoke 5bH2mQxKproton account sessions revoke --others| Flag | Description |
|---|---|
--others |
Revoke every session except this one |
settings
Section titled “settings”Account-wide preferences.
Holds get, list and set.
settings get
Section titled “settings get”Show the account settings now in effect.
proton account settings getproton account settings getsettings list
Section titled “settings list”List the account settings that can be changed.
proton account settings listproton account settings listsettings set
Section titled “settings set”Change one account setting.
proton account settings set KEY VALUEproton account settings set locale de_ATproton account settings set news offEvery command also takes the flags that work everywhere.