Change Hostname on Mac Terminal: 4 Names and a Silent Hang

To change the hostname on a Mac from Terminal, the Ask Different answer 238,901 people have viewed is three sudo scutil --set lines. I ran the same command on the Mac mini that runs this business, over SSH and without the sudo, expecting a quick "permission denied". It never came back. scutil --set HostName testx sat there for 2 minutes 18 seconds before I killed it, and the only clue was a new SecurityAgent process: macOS had opened a password dialog on a screen nobody was looking at. The plain hostname testx on the same box failed honestly in under a second with sethostname: Operation not permitted.

That hang is the main thing I want to save you from, especially if a script or an AI agent is doing the renaming. The rest of this post is why macOS has four names where Linux's hostnamectl has three, what 50 Ask Different questions say goes wrong with them, and a 25-line hostnamectl shell function that refuses to hang.

The commands, done properly

If you are at the Mac, or you can type a sudo password over SSH, this is the whole job:

sudo scutil --set ComputerName "Build Mini"
sudo scutil --set LocalHostName Build-Mini
sudo scutil --set HostName Build-Mini
sudo dscacheutil -flushcache

Check the result with scutil --get for each of the three names, then hostname. Nothing needs a reboot; new Terminal tabs pick up the prompt change, existing ones keep the old name until you open a new shell.

The hostnamectl man page describes three Linux names: a "pretty" one that can contain anything ("Lennart's Laptop"), a "static" one the user configures, and a "transient" fallback "received from network configuration". It also says: "If a static hostname is set to a valid value, then the transient hostname is not used." macOS works the same way, plus a fourth name for Bonjour:

systemd (Linux)	macOS	On this Mac mini, 2026-10-05	Set with
pretty	ComputerName	Mindful의 Mac mini	scutil --set ComputerName, or System Settings > General > About
static	HostName	not set (scutil --get exits 1)	scutil --set HostName only; no GUI field
transient	kernel hostname (sysctl kern.hostname)	Mindfului-Macmini.local	derived; hostname NAME as root, lost on reboot
(none)	LocalHostName (Bonjour, .local)	Mindfului-Macmini	scutil --set LocalHostName, or Sharing > Local hostname

Two things in that table surprised me. HostName, the one that maps to Linux's static name, is not set on this Mac at all, and Apple's support page only covers the other two. And the derived names don't follow Apple's own description, which says the local hostname is the computer name with spaces replaced by hyphens. Here the Korean syllable 의 was romanized to "ui", one space became a hyphen and the other vanished. I don't know whether macOS derived it from an older ComputerName at setup, so treat the rule as "check, don't predict".

Why "my hostname changed by itself" is the common complaint

I pulled every Ask Different question with "hostname" in the title through the Stack Exchange API: 83 questions from 2010 to 2025. 33 were about other machines' names (DNS, VPN routing, SMB, Safari), which leaves 50 about the Mac's own name. I sorted those by title:

• 29 of 50: the name changed or shows something wrong. The prompt turned into another device's name, another device's label like "HUAWEI_Y6_2019-...", a UUID, a random number, a -2 suffix, or the old machine's name after a factory reset.
• 16 of 50: how to set it, or which of the names is which.
• 5 of 50: how to print it.

The highest-voted answer on "How to refuse DHCP Server to change my hostname?" (17 votes) states the fix in one line: "DHCP overrides the LocalHostName system property, but not the HostName property." An answer on "Why is HostName not set by default?" describes the mechanism: without HostName the hostname is "derived dynamically, by doing a reverse DNS lookup on its primary IP address (or if that fails, using the local hostname)", and suggests "StaticHostName might be a better name".

On my network that lookup fails: host 192.168.20.34 returns NXDOMAIN in 14 ms and the router's DHCP packet carries no host name, so the kernel falls back to Mindfului-Macmini.local. Take the same Mac to an office whose DNS has a PTR record for its lease and the prompt changes. The -2 suffix is a different path: Bonjour finds another device answering for the same .local name, often a stale record of the Mac itself after sleep, and renames LocalHostName. Setting HostName stops the first kind of drift, not the second.

Why scutil hangs without sudo instead of failing

The scutil man page says "The --set option requires super-user access." The binary does something friendlier for a desktop user and worse for a script. Its version string is configd-1405.100.8, and prefs.c in that tag shows the branch:

if (geteuid() != 0) {
	// if we need to use a helper
	useHelper = TRUE;
	authorization = _prefs_AuthorizationCreate();
}

Not root means: ask the Authorization Services for rights, which puts up a password dialog through SecurityAgent and waits. Sitting at the Mac, you type your password and it works, which is why guides say "each command opens a dialog". Over SSH, in a launchd job, or inside an agent's shell, the dialog appears on a console nobody is watching. My first attempt ran 2 minutes 18 seconds before I killed it (exit 143). The second, under a timer, was still waiting at 10 minutes 17 seconds with no timeout in sight, and I killed that one too. The orphaned SecurityAgent process outlived both.

The fast way to find out whether you can rename non-interactively is sudo -n true. On this box it answers "a password is required" in 0.03 seconds. That is the same lesson as osascript blocking for 66 seconds on an Apple event: a macOS command that can ask a human for permission will wait for one, and a headless caller has to check first.

A hostnamectl for Mac that doesn't wait on a dialog

# hostnamectl for macOS: status, plus a set that refuses to hang
hostnamectl() {
  case "${1:-status}" in
    status)
      printf 'Pretty  (ComputerName):  %s\n' "$(scutil --get ComputerName 2>/dev/null || echo '(not set)')"
      printf 'Static  (HostName):      %s\n' "$(scutil --get HostName 2>/dev/null || echo '(not set)')"
      printf 'Bonjour (LocalHostName): %s.local\n' "$(scutil --get LocalHostName 2>/dev/null)"
      printf 'Kernel  (hostname):      %s\n' "$(sysctl -n kern.hostname)" ;;
    hostname|set-hostname)
      [ -n "$2" ] || { hostname; return 0; }
      if ! sudo -n true 2>/dev/null; then
        echo "hostnamectl: run 'sudo -v' first; scutil --set without root waits on a GUI password dialog" >&2
        return 1
      fi
      _hn=$(printf '%s' "$2" | LC_ALL=C tr -c 'A-Za-z0-9-' '-' | sed 's/--*/-/g; s/^-//; s/-$//')
      [ -n "$_hn" ] || { echo "hostnamectl: no usable characters in '$2'" >&2; return 1; }
      sudo scutil --set ComputerName "$2" &&
      sudo scutil --set LocalHostName "$_hn" &&
      sudo scutil --set HostName "$_hn" &&
      sudo dscacheutil -flushcache ;;
    *) echo "usage: hostnamectl [status | hostname [NAME]]" >&2; return 2 ;;
  esac
}

Like Linux's hostnamectl hostname NAME, it sets the pretty name as typed and a simplified version for the other two: "Build Mini" becomes Build-Mini, build_box.01 becomes build-box-01. It does not romanize: "Mindful의 Mac mini" becomes Mindful-Mac-mini, and a name with no ASCII letters is refused rather than turned into an empty string.

I tested it in zsh -f, Apple's bash 3.2.57 and /bin/sh. hostnamectl prints the four rows above. hostnamectl hostname "Lab Mini 2" without cached sudo returns 1 in under a second instead of hanging. The set path I could only run with sudo replaced by a function that echoes its arguments, because nobody types passwords into this machine, so the three scutil calls are checked for the right arguments but not executed. If you run it for real, run sudo -v first.

If you came here from Linux muscle memory, the same "what replaces this command" problem shows up with systemctl on Mac and lscpu on Mac. And if the reason you're renaming is that two Macs show up with the same name, dns-sd can list what is advertising on your network under each .local name.

FAQ

How do I change the hostname on a Mac from Terminal?

Run sudo scutil --set ComputerName "My Mac", sudo scutil --set LocalHostName My-Mac and sudo scutil --set HostName My-Mac, then sudo dscacheutil -flushcache. Open a new Terminal window to see the new name in the prompt. No reboot is needed.

Is there a hostnamectl command on macOS?

No. macOS uses scutil --get and scutil --set with three keys: ComputerName (like the pretty hostname), HostName (like the static hostname) and LocalHostName (the Bonjour .local name). The kernel's current hostname, the transient equivalent, is read with hostname or sysctl kern.hostname.

Why does my Mac's hostname keep changing?

macOS does not set HostName by default, so the name shown by hostname and in the Terminal prompt comes from a reverse DNS lookup of the Mac's IP address, or from LocalHostName when that fails. Different networks give different answers. Setting a fixed name with sudo scutil --set HostName stops that. A "-2" suffix is a separate Bonjour name conflict on the local network.

Method: on 2026-10-05 from about 21:00 KST I ran these commands over SSH on a Mac mini M4 (Mac16,10, macOS 26.4.1 build 25E253) as a normal user with no cached sudo. Both unprivileged scutil --set HostName attempts were stopped by me, and scutil --get HostName still reported "not set" afterwards. The scutil source is configd-1405.100.8, the tag named in the binary. The 83 Ask Different questions came from the Stack Exchange API title search for "hostname" the same evening; I sorted them by title only, so a few may sit in the wrong bucket, and my notes keep the question IDs per bucket. I did not run the rename with real sudo, test Intel Macs or older macOS versions, or test a network whose DNS has a PTR record for the Mac.