ref: b609977fb14b1f6da23d14a3537b24a1621a7a56 vpn-documentation/CHANGE_HOSTNAME.md -rw-r--r-- 1.2 KiB
b609977fFrançois Kooman additional comments 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!