Skip to content

Knowledgebase

Changing a Virtualmin server hostname safely

control-panels, servers

Change the Virtualmin host name as a coordinated server identity change. The operating-system hostname, public DNS, service certificates and mail identity can refer to it, while customer website domains remain separate objects.

Prepare for the change

Use authorized server administration with console access. Record the old hostname and identify dependencies such as monitoring, backups, mail HELO, reverse DNS, certificates and external allowlists. Choose a stable fully qualified hostname that is not confused with a customer website.

01 Change a Virtualmin server hostname safely

  1. Publish the new hostname address records and confirm they resolve to the intended server. Coordinate sending-IP reverse DNS with the provider when the mail design requires a matching identity.
  2. Inspect Webmin Networking > Network Configuration > Hostname and DNS Client, or the supported operating-system hostname tool for this host. Preserve resolver and interface settings; changing the hostname does not require an unrelated IP or gateway change.
  3. Set the intended hostname and review relevant local host mappings through the supported interface. Check whether cloud-init or another provisioning system manages persistent hostname values.
  4. Run the Virtualmin configuration check and review host-specific settings. Update the hostname certificate through supported SSL configuration after validation is possible.
  5. Inspect mail-server identity, monitoring and backup destinations for explicit references to the old name. Update them deliberately rather than performing a blind global text replacement.
  6. Open a new panel session at the new HTTPS hostname and test services. Retain the old DNS name temporarily if clients or operational systems still require a planned transition.

Will changing the server hostname rename customer websites?

No. Hosted domain definitions and their public DNS remain separate. Do not rename customer virtual servers unless that is an independently planned website-domain change.

Confirm the expected result

Confirm the operating system reports the intended hostname, public DNS is correct and the panel presents a matching certificate. Test outbound mail identity when applicable and verify monitoring and backups still connect. Check persistence at the next planned reboot.

If the change does not work

If the name reverts, investigate provisioning ownership before repeated manual edits. If mail or TLS fails, inspect the particular service dependency rather than renaming customer virtual servers. Use the recorded before-state to restore the old identity if the coordinated change cannot complete.

Was this answer helpful?

Need a little more help?

Our support team can help you find the next step.

Contact support