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+
8 This file is part of systemd.
10 Copyright 2010 Lennart Poettering
13 <refentry id=
"hostname">
15 <title>hostname
</title>
16 <productname>systemd
</productname>
20 <contrib>Developer
</contrib>
21 <firstname>Lennart
</firstname>
22 <surname>Poettering
</surname>
23 <email>lennart@poettering.net
</email>
29 <refentrytitle>hostname
</refentrytitle>
30 <manvolnum>5</manvolnum>
34 <refname>hostname
</refname>
35 <refpurpose>Local hostname configuration file
</refpurpose>
39 <para><filename>/etc/hostname
</filename></para>
43 <title>Description
</title>
45 <para>The
<filename>/etc/hostname
</filename> file configures the
46 name of the local system that is set during boot using the
47 <citerefentry><refentrytitle>sethostname
</refentrytitle><manvolnum>2</manvolnum></citerefentry>
48 system call. It should contain a single newline-terminated
49 hostname string. Comments (lines starting with a `#') are ignored.
50 The hostname may be a free-form string up to
64 characters in length;
51 however, it is recommended that it consists only of
7-bit ASCII lower-case
52 characters and no spaces or dots, and limits itself to the format allowed
53 for DNS domain name labels, even though this is not a strict
57 <citerefentry><refentrytitle>hostnamectl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
58 to change the value of this file during runtime from the command
60 <citerefentry><refentrytitle>systemd-firstboot
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
61 to initialize it on mounted (but not booted) system images.
</para>
65 <title>History
</title>
67 <para>The simple configuration file format of
68 <filename>/etc/hostname
</filename> originates from Debian
73 <title>See Also
</title>
75 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
76 <citerefentry><refentrytitle>sethostname
</refentrytitle><manvolnum>2</manvolnum></citerefentry>,
77 <citerefentry><refentrytitle>hostname
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
78 <citerefentry><refentrytitle>hostname
</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
79 <citerefentry><refentrytitle>machine-id
</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
80 <citerefentry><refentrytitle>machine-info
</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
81 <citerefentry><refentrytitle>hostnamectl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
82 <citerefentry><refentrytitle>systemd-hostnamed.service
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
83 <citerefentry><refentrytitle>systemd-firstboot
</refentrytitle><manvolnum>1</manvolnum></citerefentry>