ref: 13ed958d65981a2744683ffbffae1c0d2c51e36d vpn-documentation/CHANGE_HOSTNAME.md -rw-r--r-- 1.2 KiB
13ed958dFrançois Kooman make clear that "the only difference" now refers only to OAuth 4 months ago

In case you want to change the hostname of your VPN server, you need to follow these steps:

  1. Set the correct hostname;
  2. Make sure DNS is correct;
  3. Obtain new TLS certifcates and install them;
  4. Change the Apache VirtualHost configuration;
  5. Update /etc/vpn-server-api/config.php to make sure hostName (in all profiles) points to the correct name.

We assume you want to rename from vpn.example.org to vpn.example.com. Please adapt the hostname as appropriate.


$ sudo hostnamectl set-hostname vpn.example.com


Make sure the new hostname has an A (and AAAA) record to your VPN server IPs.


When your DNS is correct you can use Let's Encrypt to obtain new certificates, or manually obtain them from your CA and install them.


Rename /etc/httpd/conf.d/vpn.example.org.conf to /etc/httpd/conf.d/vpn.example.com.conf. Replace all occurences of vpn.example.org with vpn.example.com in the file.


Modify /etc/vpn-server-api/config.php and look at all hostName entries and change them to the new hostname.



$ sudo vpn-maint-apply-changes

Reboot your system to make sure everything comes back correctly. All should be done now!