ref: fd46c663b61b90594214f4ab25b347635dd80a92 vpn-documentation/CHANGE_HOSTNAME.md -rw-r--r-- 1.2 KiB
fd46c663François Kooman mention VPN Server software is licensed under AGPLv3+ 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!