Using TunSafe on POSIX compatible systems

TunSafe does not yet have a graphical user interface for Linux, OSX, or FreeBSD. However, you can compile TunSafe from source and run it from a command prompt.

Follow the instructions below to download, compile and install TunSafe on unix-like systems.

1. Download the TunSafe source code

$ git clone https://github.com/TunSafe/TunSafe.git
$ cd TunSafe

2. Install compiler environment

Linux

$ sudo apt-get install clang-6.0 

FreeBSD

$ sudo pkg install gcc7

3. Build and install TunSafe

$ make
$ sudo make install

If everything went well, you now have a tunsafe tool in the /usr/bin directory.

4. Run TunSafe

To use TunSafe you need a WireGuard configuration file from a VPN provider. You can also use the free TunSafe VPN servers. Assuming it's named TunSafe.conf, do the following to start TunSafe:

$ sudo tunsafe start -d TunSafe.conf

If everything went well, TunSafe daemonizes and continues running in the background. To instead run in the foreground, omit the -d flag.

You can verify that TunSafe is running with the tunsafe show command. It should look similar to this.

$ sudo tunsafe show
interface: tun0
  public key: 8q1SiKy7hKDTPXltp2iimxLjWpL53lRnQzms9f8LXU0=
  private key: (hidden)
  listening port: 8040

peer: T/DjhrM8hkbqYnOYQvHExF0HI/Csi6DktQth5ijcpDI=
  allowed ips: 192.168.2.0/24

Stop TunSafe by using tunsafe stop.

$ sudo tunsafe stop tun0