For simple one server deployments and tests, we have a deploy script available you can run on a fresh CentOS (or Red Hat Enterprise Linux) 7 installation. It will configure all components and will be ready for use after running!
An additional script is available after deployment:
tcp/1194for basic functionality, the deploy script will take care of the host firewall;
We test only with the official CentOS
Minimal ISO and the official
Cloud images. For Red Hat Enterprise Linux
we test with the official Red Hat Enterprise Linux ISO, e.g.
If you have a more complicated setup, we recommend to manually walk through the deploy script and follow the steps.
Perform these steps on the host where you want to deploy:
$ curl -L -O https://github.com/eduvpn/documentation/archive/v2.tar.gz $ tar -xzf v2.tar.gz $ cd documentation-2
Run the script (as root):
$ sudo -s # ./deploy_centos.sh
Specify the hostname you want to use for your VPN server. The recommended hostname SHOULD already be the one you want to use... If not, set the hostname correctly first.
NOTE: you can NOT use
localhost as a hostname, nor an IP address!
NOTE: by default there is NO firewall for the traffic between VPN client and VPN server. So if you have SSH running on your server, the clients will be able to connect to it when you don't take additional steps! Look here.
NOTE: if you want to use the development repository, use:
# VPN_DEV_REPO=1 ./deploy_centos.sh
Periodically install updates! Run the following command periodically, e.g. every week during the maintenance window. Reboot your server as required for kernel / system library updates.
$ sudo vpn-maint-update-system
If the command is not available, install the
vpn-maint-scripts package first.
See PROFILE_CONFIG on how to update the VPN server settings.
By default there is a user
admin with a generated password for
portal access. Those are printed at the end of the deploy script.
If you want to update/add users you can use the
Provide an existing account to update the password:
$ sudo vpn-user-portal-add-user User ID: foo Setting password for user "foo" Password: Password (repeat):
You can configure which user(s) is/are an administrator by setting the
adminUserIdList option in
'adminUserIdList' => ['admin'],
It is easy to enable LDAP authentication. This is documented separately. See LDAP.
It is easy to enable RADIUS authentication. This is documented separately. See RADIUS.
It is easy to enable SAML authentication for identity federations, this is documented separately. See SAML.
It is possible to enable 2FA with TOTP.
If you want to restrict the use of the VPN a bit more than on whether someone has an account or not, e.g. to limit certain profiles to certain (groups of) users, see ACL.
By default a self-signed certificate is used for the web server. You can
install your own certificates, and tweak
/etc/httpd/conf.d/vpn.example.org.conf to point to them, or use Let's Encrypt
using the script mentioned below.
Run the script (as root) from the documentation folder:
$ sudo -s # ./lets_encrypt_centos.sh
Make sure you use the exact same DNS name you used when running
After completing the script, the certificate will be installed and the system will automatically replace the certificate before it expires.
If you also want to allow clients to connect with the VPN over