Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Mullvad VPN CLI Commands


Most Used

CommandDescription
mullvad account loginLog in to your Mullvad account.
mullvad account getShow your account information, including account number, device name, and expiration date.
mullvad relay listList available server locations.
mullvad relay set location <country_code> <city_code>Select a server location. Replace <country_code> and <city_code> with your desired values.
mullvad relay set location <server_name>Select a specific server by name.
mullvad connectConnect to the selected server location.
mullvad disconnectDisconnect from the VPN.
mullvad status -vCheck your connection status with detailed information.
mullvad auto-connect set onEnable auto-connect on startup.
mullvad lockdown-mode set onEnable Lockdown mode to block all Internet traffic until connected to Mullvad.
mullvad dns set default --block-ads --block-trackers --block-malware --block-adult-contentTo enable all DNS filters except social media, use the following command.
mullvad relay set tunnel-protocol wireguardUse Wireguard as the tunnel protocol (Is default).
mullvad tunnel set wireguard --quantum-resistant onEnable Quantum Resistant.

Basic Commands

CommandDescription
mullvad account login <account_number>Log in to your Mullvad account. Replace <account_number> with your actual account number.
mullvad account getShow your account information, including account number, device name, and expiration date.
mullvad account list-devicesList all device names associated with your account.
mullvad relay listList available server locations.
mullvad relay set location <country_code> <city_code>Select a server location. Replace <country_code> and <city_code> with your desired values.
mullvad relay set location <server_name>Select a specific server by name.
mullvad connectConnect to the selected server location.
mullvad disconnectDisconnect from the VPN.
mullvad relay updateForce an update of the server location list.
mullvad status -vCheck your connection status with detailed information.

Advanced Commands

CommandDescription
mullvad relay set tunnel-protocol openvpnUse OpenVPN as the tunnel protocol.
mullvad relay set tunnel openvpn --transport-protocol tcpUse OpenVPN over TCP.
mullvad relay set tunnel-protocol wireguardUse Wireguard as the tunnel protocol (Is default).
mullvad auto-connect set onEnable auto-connect on startup.
mullvad auto-connect set offDisable auto-connect on startup.
mullvad lan set allowEnable LAN access.
mullvad lockdown-mode set onEnable Lockdown mode to block all Internet traffic until connected to Mullvad.
mullvad tunnel set ipv6 onEnable in-tunnel IPv6.

Split Tunneling (Linux)

CommandDescription
mullvad-exclude <program>Start a new process excluded from Mullvad.
mullvad split-tunnel add <pid>Exclude a running process from Mullvad using its PID.
mullvad split-tunnel listList all currently excluded processes.
mullvad split-tunnel delete <pid>To restore a previously excluded process use this command.
mullvad split-tunnel clearTo restore all previously excluded processes use this command.

Shadowsocks Commands

CommandDescription
mullvad bridge set location <location>Set the location for Shadowsocks. Replace <location> with a specific country or city.
mullvad bridge set state onEnable bridge mode for Shadowsocks.
mullvad bridge set state offDisable bridge mode.
mullvad bridge set custom set shadowsocks --cipher <CIPHER> <REMOTE_IP> <REMOTE_PORT> <PASSWORD>Configure advanced Shadowsocks settings.

DNS Commands

CommandDescription
mullvad dns set default --helpTo view the help, use this command.
mullvad dns set default --block-ads --block-trackers --block-malware --block-gambling --block-adult-contentTo enable all DNS filters except social media, use the following command.
mullvad dns set defaultTo turn off all the content blockers use this command.

Make custom server lists

CommandDescription
mullvad custom-list new FavoritesTo create a new custom list named "Favorites" use this command.
mullvad custom-list edit add Favorites se-mma-wg-001To add a specific server, city or country to the list use one of these commands.
mullvad custom-list edit add Favorites se gotTo add a specific server, city or country to the list use one of these commands.
mullvad custom-list edit add Favorites seTo add a specific server, city or country to the list use one of these commands.
mullvad relay set custom-list FavoritesTo select your custom list so you can connect to it, use this command.
mullvad custom-list edit remove Favorites se-mma-wg-001To remove a specific server,city or country from the list use one of these commands. (The same as add)
mullvad custom-list edit rename Favorites FavouritesTo rename a custom list use this command.
mullvad custom-list listTo list all your custom lists and their content use this command.

Reset Settings

CommandDescription
mullvad factory-resetThis command performs a factory reset on all settings, deletes app logs and cache files, disconnects the app, and logs you out.

Official Page

Mullvad Cli