ref: fefa8a67d1bb4afa2d24cda3dea66e940a5f9a95 vpn-documentation/CHANGE_HOSTNAME.md -rw-r--r-- 1.2 KiB
fefa8a67François Kooman remove EXPIRY_AT_NIGHT 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!