macOS

OpenVPN

Tunnelblick instructions

Viscosity instructions

WireGuard®

WireGuard instructions


Tunnelblick

  1. Download Tunnelblick from their website, run the .dmg file and double click the icon to start Tunnelblick.
  2. Go to our OpenVPN config generator page and download a config.
    To make things easier, use the inline <auth-user-pass> described at the bottom of that page.
  3. On some WiFi networks, you might need to set the MTU to 1400, at least for the UDP configs.
    To do this on the config generator page, in the box at the bottom, add: mssfix 1400
  4. Once you've downloaded the config(s), click the Tunnelblick icon at the top right, then click VPN Details to open the main window.
  5. Click the Downloads button at the bottom right of your screen and drag the config you just downloaded into the Tunnelblick window, in the Configurations section to the left.
  6. Once the config is imported, select it from the Configurations list, then click the Connect button to the bottom right.
  7. That's it! Check with https://cryptostorm.is/test to verify that your IP has changed.

Viscosity

  1. Viscosity is NOT freeware, but it does have a 30 day free trial. The full version is $14
  2. Download Viscosity from their website, run the .dmg file and double click the icon to start Viscosity (or drag it to the Applications folder to install it).
  3. Go to our OpenVPN config generator page and download a config.
    To make things easier, use the inline <auth-user-pass> described at the bottom of that page.
  4. On some WiFi networks, you might need to set the MTU to 1400, at least for the UDP configs.
    To do this on the config generator page, in the box at the bottom, add: mssfix 1400
  5. Once you've downloaded the config(s), click the Visocisty icon at the top right, then click Settings to open the main window.
  6. Click the + button at the bottom left, then click Import Connection, then From File, then navigate to the Downloads folder, then select the config you just downloaded.
  7. Once the config is imported, select it from the Settings window, then click the Edit button to the bottom right.
    Click the Authentication tab, then the Use Username/Password authentication checkbox. Click the Save button at the bottom right.
  8. Now you can right click it in this Settings window and click Connect, or you can do from the Viscosity icon in the top right of your screen.
  9. That's it! Once it shows a green Connected, you can check with https://cryptostorm.is/test to verify that your IP has changed.


WireGuard

(Source code available on wireguard.com)

  1. Copy your cryptostorm token from the delivery page, then paste it into the Simple box on our WireGuard config generator page.
  2. After you click the Generate button, scroll down a bit and click All configs to expand that section.
  3. Be sure to enable the killswitch option. In our tests, traffic wouldn't flow without it.
  4. Click DOWNLOAD CONFIGS to save configs.zip, then install WireGuard from the App Store, then open it.
  5. On the main WireGuard screen, click the "Import tunnel(s) from file" button. Navigate to the Downloads folder, then the configs folder (MacOS automatically unzips .zip files).
    If you hold click the first file, then hold down the shift button, then click the last file, you can select all the configs at once.
    Click the Import button to import all the configs, then Allow when it asks if WireGuard can add VPN configurations.
  6. Select a node from the list, and click the Activate button to connect.
  7. That's it! Check with https://cryptostorm.is/test to verify that your IP has changed.