How to Change the Hostname in Linux

A hostname is the unique label assigned to a device on a network. When you provision a new Linux server, cloud providers often generate a random, unreadable string of characters as the default hostname. In a local environment, your installation might default to simply “ubuntu” or “localhost”. Changing the hostname to something descriptive—such as “web-server-01” or “database-primary”—is a critical first step in server administration, ensuring you can quickly identify machines in logs, terminal prompts, and network monitoring tools.

Why the Hostname Matters

Your hostname appears constantly. It is the name shown in your command prompt (e.g., user@hostname:~$), it is how the machine identifies itself to DHCP servers, and it is the label attached to system logs. If you manage multiple servers and they all have the same default hostname, executing a command on the wrong machine becomes a dangerous probability.

Step-by-Step: Changing the Hostname (Modern Systemd Linux)

Most modern Linux distributions (including Ubuntu 16.04+, CentOS 7+, Debian 8+, and Fedora) use systemd, which provides a dedicated tool for managing hostnames.

1. Open your terminal or connect to the server via SSH.
2. To check your current hostname, run the following command:
   hostnamectl
3. To change the hostname, use the set-hostname command followed by your new desired name. You must run this with root privileges:
   sudo hostnamectl set-hostname new-server-name
4. Verify the change by running hostnamectl again. The ‘Static hostname’ field should reflect your new name.

This command updates the system configuration instantly, without requiring a reboot.

Updating the /etc/hosts File

While hostnamectl changes the system’s identity, you must also update the local hosts file. This file maps the hostname to the local loopback IP address. If you fail to do this, some applications (and the sudo command itself) may experience delays or errors as they try to resolve the old, nonexistent hostname.

1. Open the hosts file in a text editor like Nano:
   sudo nano /etc/hosts
2. Look for a line that begins with 127.0.1.1 or 127.0.0.1 followed by your old hostname.
3. Change the old hostname to your new one.
4. Save the file and exit the editor (in Nano, press Ctrl+O to save, then Enter, then Ctrl+X to exit).

Troubleshooting Common Mistakes

If you encounter issues after changing your hostname, check these common constraints:

• Invalid Characters: A valid hostname must consist only of lowercase letters (a-z), digits (0-9), and hyphens (-). It cannot contain spaces, underscores, or special characters, and it cannot begin or end with a hyphen. If you use invalid characters, network services may fail to start.
• Cloud Provider Overrides: If you are using a cloud provider like AWS or DigitalOcean, the cloud-init service might overwrite your hostname every time the server reboots to match what is configured in their dashboard. To permanently change the name, you may need to update the configuration file at /etc/cloud/cloud.cfg and set preserve_hostname: true.

By maintaining clear, descriptive hostnames, you significantly reduce the risk of administrative errors across your Linux infrastructure.