Skip to content


sshuttle is a lightweight SSH-encrypted VPN. This is a Python based script that allows you to tunnel connections through SSH in a far more efficient way then traditional ssh proxying.

Installing sshuttle Server

You can spin up a new instance with "ubuntu-21.04-x86_64" flavor named "sshuttle_server" on OpenStack, with "default" and "ssh_only" Security Groups attached to it.

Available instances

Also, attach a Floating IP to this instance so you can ssh into it from outside.

Security Groups

Finally, you'll want to configure the setting for the remote instances in your SSH configuration file (typically found in ~/.ssh/config). The SSH configuration file might include entry for your newly create sshuttle server like this:

Host sshuttle

  User ubuntu
  IdentityFile ~/.ssh/cloud.key
  1. Then you can ssh into the sshuttle Server running: ssh sshuttle

SSH sshuttle server


Unlike other VPN servers, for sshuttle you don't need to install anything on the server side. As long as you have an SSH server (with python3 installed) you're good to go.

To connect from a new client

Install sshuttle


Currently there is no built in support for running sshuttle directly on Microsoft Windows. What you can do is to create a Linux VM with Vagrant (or simply Virtualbox if you like) and then try to connect via that VM. For more details read here

Mac OS X

Install using Homebrew:

brew install sshuttle

OR, via MacPorts

sudo port selfupdate
sudo port install sshuttle


sshuttle is available through the package management system on most Linux distributions.

On Debian/Ubuntu:

sudo apt-get install sshuttle

On RedHat/CentOS:

sudo yum install sshuttle

It is also possible to install into a virtualenv as a non-root user.

  • From PyPI:
virtualenv -p python3 /tmp/sshuttle
 . /tmp/sshuttle/bin/activate
 pip install sshuttle
  • Clone:
virtualenv -p python3 /tmp/sshuttle
 . /tmp/sshuttle/bin/activate
 git clone [](
 cd sshuttle
 ./ install

How to Connect

Tunnel to all networks (

sshuttle -r ubuntu @

OR, shorthand:

sudo sshuttle -r ubuntu@ 0/0

If you would also like your DNS queries to be proxied through the DNS server of the server, you are connected to:

sshuttle --dns -r ubuntu@ 0/0

sshuttle Client connected