1 <?xml version='
1.0'
?> <!--*-nxml-*-->
2 <!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
6 SPDX-License-Identifier: LGPL-2.1+
9 <refentry id=
"hostname">
11 <title>hostname
</title>
12 <productname>systemd
</productname>
16 <refentrytitle>hostname
</refentrytitle>
17 <manvolnum>5</manvolnum>
21 <refname>hostname
</refname>
22 <refpurpose>Local hostname configuration file
</refpurpose>
26 <para><filename>/etc/hostname
</filename></para>
30 <title>Description
</title>
32 <para>The
<filename>/etc/hostname
</filename> file configures the
33 name of the local system that is set during boot using the
34 <citerefentry><refentrytitle>sethostname
</refentrytitle><manvolnum>2</manvolnum></citerefentry>
35 system call. It should contain a single newline-terminated
36 hostname string. Comments (lines starting with a `#') are ignored.
37 The hostname may be a free-form string up to
64 characters in length;
38 however, it is recommended that it consists only of
7-bit ASCII lower-case
39 characters and no spaces or dots, and limits itself to the format allowed
40 for DNS domain name labels, even though this is not a strict
44 <citerefentry><refentrytitle>hostnamectl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
45 to change the value of this file during runtime from the command
47 <citerefentry><refentrytitle>systemd-firstboot
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
48 to initialize it on mounted (but not booted) system images.
</para>
52 <title>History
</title>
54 <para>The simple configuration file format of
55 <filename>/etc/hostname
</filename> originates from Debian
60 <title>See Also
</title>
62 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
63 <citerefentry><refentrytitle>sethostname
</refentrytitle><manvolnum>2</manvolnum></citerefentry>,
64 <citerefentry><refentrytitle>hostname
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
65 <citerefentry><refentrytitle>hostname
</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
66 <citerefentry><refentrytitle>machine-id
</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
67 <citerefentry><refentrytitle>machine-info
</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
68 <citerefentry><refentrytitle>hostnamectl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
69 <citerefentry><refentrytitle>systemd-hostnamed.service
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
70 <citerefentry><refentrytitle>systemd-firstboot
</refentrytitle><manvolnum>1</manvolnum></citerefentry>