Back to Guides

Shadowsocks with the Mullvad VPN app

Unable to surf the entire web because you're stuck behind a restrictive firewall? Then Shadowsocks might be your answer.

In this guide, we'll walk you through the steps to use this proxy to connect to our servers using the Mullvad VPN app.
 

What is Shadowsocks?

Please see our Intro to Shadowsocks guide.
 

Installation requirements

To use this guide, you need

  • Windows, macOS, or Linux
  • version 2019.2 or newer of the Mullvad VPN app – download it here
  • to use the terminal/command prompt.
     

Set-up instructions

1. Launch the app

Open the Mullvad VPN app and connect to whichever exit location you prefer.

(Alternatively, you can connect to the app after you've turned on Shadowsocks. In this case, your Shadowsocks setting will be saved until then.)
 

2. Open the terminal

Windows
Open the command prompt and navigate to C:\Program Files\Mullvad VPN\resources\

Run the command "mullvad" to start the Mullvad CLI. (If you get "error: 'mullvad' requires a subcommand...", then it's already started.)

macOS
Open the terminal and navigate to /Applications/Mullvad VPN.app/Contents/Resources

Linux
Open the terminal.
 

3. Turn on Shadowsocks

Run the following command, replacing xxx.xxx.xxx.xx with the IP address of the Mullvad bridge server you want to use as your entry location.

Windows and Linux

mullvad tunnel openvpn proxy set shadowsocks xxx.xxx.xxx.xx 

macOS

./mullvad tunnel openvpn proxy set shadowsocks xxx.xxx.xxx.xx

Once you've turned Shadowsocks on, you can continue to use the app as usual.

If you're already connected in the app when you turn on Shadowsocks, notice that the app will automatically reconnect in order to implement this new configuration.
 

4. Turn off Shadowsocks

Windows and Linux

mullvad tunnel openvpn proxy unset

macOS

./mullvad tunnel openvpn proxy unset

If you're already connected in the app when you turn off Shadowsocks, notice that the app will automatically reconnect.
 

Is Shadowsocks on or off?

Run the following command.

Windows and Linux

mullvad tunnel openvpn proxy get

macOS

./mullvad tunnel openvpn proxy get

If you have it turned off, the message "proxy: unset" will display.

If it's turned on, you will see the Shadowsocks proxy details.
 

How do I know Shadowsocks is working?

Run the above get command to see if it's turned on. If it is, this is the only way to know that Shadowsocks is working. Nothing in the app or on am.i.mullvad.net will verify this.