Change Hostname
This page explains how to change the server's hostname in GoAdmio. The hostname is the server's own name on the network — used in mail headers, SSL certificates for system services, logs, and the panel banner.
Location: Admin Panel → Networking Setup → Change Hostname
Overview
Every GoAdmio server has a fully qualified domain name (FQDN) as its hostname — for example, mail.gopanel.org, server1.example.com, or srv01.yourdomain.com. The hostname appears in:
- The panel header (top bar)
- Mail server HELO/EHLO and headers (e.g.,
Received:lines) - System service SSL certificate (panel, mail, FTP)
- System logs
- DNS PTR records (reverse DNS)
/etc/hostnameand INLINECODE5
> Warning: Changing the hostname is a server-wide change. It can break email, SSL certificates, and DNS if the new hostname is not already configured correctly. Plan the change carefully, and do it during a maintenance window if the server is in production.
Prerequisites
Before changing the hostname, make sure:
- The new hostname is a valid FQDN in a domain you control — e.g.,
server1.example.com, notserver1orserver1.local. - An A record exists for the new hostname, pointing to the server's public IPv4 address.
- An AAAA record exists (if the server has IPv6) pointing to the server's IPv6 address.
- A PTR (reverse DNS) record at your hosting provider points from the server IP back to the new hostname.
- The domain is not already used by a hosting account on the server — the hostname must be a server-level name, not a customer's primary domain.
- You have a current backup or snapshot of the server.