qubes-doc/configuration/vpn.md

59 lines
2.7 KiB
Markdown
Raw Normal View History

2014-05-23 06:42:09 -04:00
---
2015-04-10 16:17:45 -04:00
layout: doc
2014-05-23 06:42:09 -04:00
title: VPN
permalink: /doc/vpn/
redirect_from:
- /doc/privacy/vpn/
- /en/doc/vpn/
- /doc/VPN/
- /wiki/VPN/
2014-05-23 06:42:09 -04:00
---
2014-05-23 08:47:14 -04:00
How To make a VPN Gateway in Qubes
----------------------------------
2014-05-23 06:42:09 -04:00
2016-01-31 22:11:18 -05:00
Setting up a VPN connection is really not Qubes specific and is documented in your operating system documentation. The relevant documentation for the Qubes default Guest OS (Fedora) is [Establishing a VPN Connection](https://docs.fedoraproject.org/en-US/Fedora/23/html/Networking_Guide/sec-Establishing_a_VPN_Connection.html)
2014-05-23 06:42:09 -04:00
The Qubes specific part is to choose the right VM for the VPN client:
2014-05-23 06:42:09 -04:00
### NetVM
2016-01-31 22:11:18 -05:00
The simplest case is to set up a VPN connection using the NetworkManager service inside your NetVM. Because the NetworkManager service is already started, you are ready to set up your VPN connection. However this has some disadvantages:
2014-05-23 06:42:09 -04:00
2016-01-31 22:11:18 -05:00
- You have to place (and probably save) your VPN credentials inside the NetVM, which is directly connected to the outside world
- All your AppVMs which are connected to the NetVM will be connected to the VPN (by default)
2014-05-23 06:42:09 -04:00
2014-05-23 10:16:18 -04:00
### AppVM
2016-01-31 22:11:18 -05:00
While the NetworkManager service is not started here (for a good reason), you can configure any kind of VPN client in your AppVM as well. However this is only suggested if your VPN client has special requirements.
2014-05-23 10:16:18 -04:00
2014-05-23 06:42:09 -04:00
### ProxyVM
2016-01-31 22:11:18 -05:00
**WARNING:** *You need to use Qubes 3.1-rc2 (or later)! In the previous releases the NetworkManager service was not working in ProxyVMs as expected.* ([#1052](https://github.com/QubesOS/qubes-issues/issues/1052))
2014-09-22 03:50:21 -04:00
2016-01-31 22:11:18 -05:00
One of the best thing in Qubes is that you can use a special type of VM called a ProxyVM (or FirewallVM). The special thing is that your AppVMs see this as a NetVM, and your NetVMs see it as an AppVM. Because of this, you can place a ProxyVM between your AppVMs and your NetVM. This is how the default FirewallVM functions.
2014-05-23 06:42:09 -04:00
Using a ProxyVM to set up a VPN client gives you the ability to:
2014-05-23 06:42:09 -04:00
2016-01-22 05:23:37 -05:00
- Separate your VPN credentials from Your NetVM
2014-05-23 06:42:09 -04:00
- Separate your VPN credentials from Your AppVM data.
- Easily control which of your AppVMs are connected to your VPN by simply setting it as a NetVM of the desired AppVM.
2014-05-23 06:42:09 -04:00
2014-05-23 08:18:21 -04:00
**To setup a ProxyVM as a VPN gateway you should:**
2014-05-23 06:42:09 -04:00
2016-01-22 05:23:37 -05:00
1. Create a new VM and check the ProxyVM radio button.
2014-05-23 08:15:00 -04:00
2015-11-04 15:14:02 -05:00
![Create\_New\_VM.png](/attachment/wiki/VPN/Create_New_VM.png)
2014-05-23 08:15:00 -04:00
2016-01-22 05:23:37 -05:00
2. Add the `network-manager` service to this new VM.
2014-05-23 08:15:00 -04:00
2015-11-04 15:14:02 -05:00
![Settings-services.png](/attachment/wiki/VPN/Settings-services.png)
2014-05-23 08:18:21 -04:00
2016-01-31 22:11:18 -05:00
3. Set up your VPN as described in the NetworkManager documentation linked above.
2014-05-23 08:15:00 -04:00
2016-01-31 22:11:18 -05:00
4. Configure your AppVMs to use the new VM as a NetVM.
2015-11-04 15:14:02 -05:00
![Settings-NetVM.png](/attachment/wiki/VPN/Settings-NetVM.png)
2016-01-31 22:11:18 -05:00
5. Optionally, you can install some [custom icons](https://github.com/Zrubi/qubes-artwork-proxy-vpn) for your VPN