---
name: "hostname"
section: "1"
platform: "macos"
package: "shell_cmds"
version: "329"
release: "macOS 26.5"
platforms: ["linux", "freebsd", "openbsd", "macos"]
url: "https://new.carta.tech/hostname"
---

# hostname(1)

set or print name of current host system

## NAME

**hostname** – set or print name of current host system

## SYNOPSIS

**hostname** \[**-f**\] \[**-s** \| **-d**\] \[*name-of-host*\]

## DESCRIPTION

The **hostname** utility prints the name of the current host. The super-user can set the hostname by supplying an argument. To keep the hostname between reboots, run ‘scutil --set HostName *name-of-host*’.

Options:

- **-f**

  Include domain information in the printed name. This is the default behavior.

- **-s**

  Trim off any domain information from the printed name.

- **-d**

  Only print domain information.

## EXAMPLES

Set the host name of the machine and check the result:

```
$ hostname beastie.localdomain.org
$ hostname
beastie.localdomain.org
```

Do not show domain information:

```
$ hostname -s
beastie
```

Show only domain information:

```
$ hostname -d
localdomain.org
```

## SEE ALSO

[gethostname(3)](/gethostname/3.md), [scutil(8)](/scutil/8.md)

## HISTORY

The **hostname** command appeared in 4.2BSD.