Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/mullvad/mullvadvpn-app/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The mullvad account command provides account management functionality including account creation, login, logout, device management, and voucher redemption.

​
Syntax

mullvad account <SUBCOMMAND>

​
Subcommands

​
create

Create and log in to a new Mullvad account: 
mullvad account create
Generates a new account number and automatically logs you in.

​
login

Log in to an existing account: 
mullvad account login [ACCOUNT_NUMBER]
If no account number is provided, you’ll be prompted to enter one.

​
logout

Log out from the current account: 
mullvad account logout
Removes the device from your Mullvad account.

​
get

Display information about the current account: 
mullvad account get [OPTIONS]
Options:
  • -v, --verbose - Enable verbose output including device ID and public key

​
list-devices

List all devices associated with an account: 
mullvad account list-devices [OPTIONS]
Options:
  • -a, --account <ACCOUNT> - Mullvad account number (uses current account if not specified)
  • -v, --verbose - Show detailed device information including IDs and public keys

​
revoke-device

Revoke a device from an account: 
mullvad account revoke-device <DEVICE> [OPTIONS]
Arguments:
  • <DEVICE> - Name or UID of the device to revoke
Options:
  • -a, --account <ACCOUNT> - Mullvad account number (uses current account if not specified)

​
redeem

Redeem a voucher code: 
mullvad account redeem <VOUCHER>
Arguments:
  • <VOUCHER> - Voucher code to submit

​
Examples

​
Create New Account

mullvad account create
Output: 
New account created!
Mullvad account:    1234567890123456
Expires at:         2026-04-03 10:30:00 +01:00
Device name:        laptop

​
Login to Account

With account number as argument: 
mullvad account login 1234567890123456
Interactive login (prompts for account number): 
mullvad account login
Output: 
Enter an account number: 1234567890123456
Mullvad account "1234567890123456" set

​
Check Account Information

Basic account info: 
mullvad account get
Output: 
Mullvad account:    1234567890123456
Expires at:         2026-04-03 10:30:00 +01:00
Device name:        laptop
Verbose account info: 
mullvad account get --verbose
Output: 
Mullvad account:    1234567890123456
Expires at:         2026-04-03 10:30:00 +01:00
Account id:         abc123def456
Device name:        laptop
Device id:          device-uuid-here
Device pubkey:      wg-public-key-here
Device created:     2025-03-03 10:30:00 +01:00

​
List Devices

List devices on current account: 
mullvad account list-devices
Output: 
Devices on the account:
laptop
phone
desktop
Verbose device listing: 
mullvad account list-devices --verbose
Output: 
Devices on the account:

Name      : laptop
Id        : device-uuid-1
Public key: wg-public-key-1
Created   : 2025-03-03 10:30:00 +01:00

Name      : phone
Id        : device-uuid-2
Public key: wg-public-key-2
Created   : 2025-03-02 15:20:00 +01:00

​
Revoke Device

Revoke by device name: 
mullvad account revoke-device laptop
Revoke by device ID: 
mullvad account revoke-device device-uuid-1
Revoke device from specific account: 
mullvad account revoke-device phone --account 1234567890123456
Output: 
Removed device

​
Redeem Voucher

mullvad account redeem ABCD1234EFGH5678
Output: 
Added 30 days to the account
New expiry date: 2026-05-03 10:30:00 +01:00

​
Logout

mullvad account logout
Output: 
Removed device from Mullvad account

​
Account States

The account can be in one of three states:
  1. LoggedIn - Successfully logged in with active device
  2. LoggedOut - Not logged in to any account
  3. Revoked - Device has been revoked from the account
  • connect - Connect to VPN (requires active account)
  • status - Check connection and account status

​
Exit Status

CodeDescription
0Command executed successfully
1Command failed (e.g., invalid account, device not found)

​
Notes

  • Account numbers are 16-digit identifiers
  • Voucher codes accept alphanumeric characters (non-alphanumeric characters are automatically removed)
  • Device names and IDs are case-insensitive when revoking
  • The CLI automatically updates device information before displaying account details
  • Devices are sorted by creation date when listing

​
Source Reference

Implementation: mullvad-cli/src/cmds/account.rs

Build docs developers (and LLMs) love

Get started for freeTalk to us