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