GoAdmio
GoAdmio Documentation

Change Hostname

From the GoAdmio knowledge base.

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/hostname and INLINECODE5
A properly configured hostname is important for email deliverability: receivers check that your server identifies itself with a valid FQDN that resolves forward and backward.

> 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:

  1. The new hostname is a valid FQDN in a domain you control — e.g., server1.example.com, not server1 or server1.local.
  2. An A record exists for the new hostname, pointing to the server's public IPv4 address.
  3. An AAAA record exists (if the server has IPv6) pointing to the server's IPv6 address.
  4. A PTR (reverse DNS) record at your hosting provider points from the server IP back to the new hostname.
  5. 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.
  6. You have a current backup or snapshot of the server.
> Tip: Verify DNS resolution for the new hostname before changing anything: ```bash dig +short server1.example.com host server1.example.com
↑