hostnamectl Command in Linux: Syntax, Options & Practical Examples (systemd)

When you need more than a one-line hostname — for example during onboarding or when filing a support ticket — hostnamectl status prints static and pretty names plus OS, kernel, architecture, and hardware hints.

Run the command:

hostnamectl status

Sample output:

Static hostname: server1
       Icon name: computer-vm
         Chassis: vm 🖴
      Machine ID: 22e961a5781c41b3bed7f02bb85a0a9b
         Boot ID: eb6453538d0841eb8fdc238594229fa7
    Product UUID: 9afb8dbd-2056-804d-a653-e1327d964ce7
    AF_VSOCK CID: 1
  Virtualization: oracle
Operating System: Ubuntu 25.04
          Kernel: Linux 7.0.0-27-generic
    Architecture: x86-64
 Hardware Vendor: innotek GmbH
  Hardware Model: VirtualBox
 Hardware Serial: VirtualBox-bd8dfb9a-5620-4d80-a653-e1327d964ce7
Firmware Version: VirtualBox
   Firmware Date: Fri 2006-12-01
    Firmware Age: 19y 6month 4w 2d

The static hostname is what hostname and SSH banners usually show. Pretty hostname stays empty until you set one — it is meant for display names with spaces or UTF-8 characters.

Scripts and quick checks often need just the hostname string, not the full status block.

Run the command:

hostnamectl hostname

Sample output:

server1

This matches hostname on most systemd hosts. Use hostnamectl status when you also need kernel or OS lines — for example on the check Ubuntu version workflow.

Renaming a server for a test or golden image usually means changing the static hostname. Save the old name first so you can restore it after testing.

Record the current name, set a new static hostname, confirm, then restore:

ORIG=$(hostnamectl hostname)
sudo hostnamectl --static hostname lab-static-test
hostnamectl hostname
sudo hostnamectl --static hostname "$ORIG"
hostnamectl hostname

Sample output (middle lines — your names will differ):

lab-static-test
server1

--static writes /etc/hostname. Without --transient or --pretty, plain hostnamectl hostname NAME also targets the static name. Revert the hostname on shared systems when you finish testing.

The pretty hostname is for humans — dashboards, desktop labels, or inventory screens. It does not replace the static hostname used in DNS or /etc/hosts.

Set a pretty name and read it back:

sudo hostnamectl --pretty hostname 'Lab Server'
hostnamectl status | head -5
sudo hostnamectl --pretty hostname ''
hostnamectl status | head -3

Sample output after setting pretty name:

Static hostname: server1
 Pretty hostname: Lab Server
       Icon name: computer-vm
         Chassis: vm 🖴
      Machine ID: 22e961a5781c41b3bed7f02bb85a0a9b

Clearing with an empty string removes the pretty name. Static server1 stays unchanged — only the display field moves.

Chassis describes the machine form factor — vm, server, desktop, and other values from the freedesktop hostnamed API. Monitoring tools can use it to group assets.

Read chassis, change it for a test, then put the original value back:

hostnamectl chassis
sudo hostnamectl chassis server
hostnamectl chassis
sudo hostnamectl chassis vm
hostnamectl chassis

Sample output:

vm
server
vm

On this VM, systemd already detected vm from virtualization metadata. Override only when auto-detection is wrong — for example a bare-metal box mis-tagged as desktop.

Ansible facts, custom agents, and shell pipelines often need structured fields instead of parsing the human status layout.

Short JSON on one line:

hostnamectl --json=short status

Sample output (truncated — one line on the host):

{"Hostname":"server1","StaticHostname":"server1","PrettyHostname":null,"DefaultHostname":"localhost","HostnameSource":"static","IconName":"computer-vm","Chassis":"vm",...}

Pretty-printed JSON for reading:

hostnamectl --json=pretty status | head -15

Sample output:

{
	"Hostname" : "server1",
	"StaticHostname" : "server1",
	"PrettyHostname" : null,
	"DefaultHostname" : "localhost",
	"HostnameSource" : "static",
	"IconName" : "computer-vm",
	"Chassis" : "vm",
	"Deployment" : null,
	"Location" : null,
	"KernelName" : "Linux",
	"KernelRelease" : "7.0.0-27-generic",
	"KernelVersion" : "#27-Ubuntu SMP PREEMPT_DYNAMIC Thu Jun 18 19:13:49 UTC 2026",
	"OperatingSystemPrettyName" : "Ubuntu 25.04",

Use --json=short in pipelines; use pretty or -j on an interactive terminal.

deployment and location are free-form strings — useful for datacenter rows, cloud environment tags (production, staging), or CMDB exports. They do not affect DNS.

Set both, verify, then clear:

sudo hostnamectl deployment production
hostnamectl deployment
sudo hostnamectl location 'Rack A1'
hostnamectl location
sudo hostnamectl deployment ''
sudo hostnamectl location ''

Sample output:

production
Rack A1

Empty output after clearing means the field is unset. Pair these with your asset database keys so automation can query one host and learn where it lives.

systemd keeps three hostname layers: static (persistent file), transient (runtime, often from DHCP or NetworkManager), and pretty (display). When a static name exists, a transient change may be ignored.

Try a transient name while static is set:

sudo hostnamectl --transient hostname lab-transient
hostnamectl hostname
hostnamectl status | head -3

Sample output on a host that already has a static name:

Hint: static hostname is already set, so the specified transient hostname will not be used.
server1
 Static hostname: server1
       Icon name: computer-vm
         Chassis: vm 🖴

For a durable rename, change the static hostname (and update DNS, TLS certs, and /etc/hosts on peers). Use transient only on hosts without a static name, or clear static first in a controlled maintenance window.