1MACHINE-INFO(5)                  machine-info                  MACHINE-INFO(5)
2
3
4

NAME

6       machine-info - Local machine information file
7

SYNOPSIS

9       /etc/machine-info
10

DESCRIPTION

12       The /etc/machine-info file contains machine metadata.
13
14       The basic file format of machine-info is a newline-separated list of
15       environment-like shell-compatible variable assignments. It is possible
16       to source the configuration from shell scripts, however, beyond mere
17       variable assignments no shell features are supported, allowing
18       applications to read the file without implementing a shell compatible
19       execution engine.
20
21       /etc/machine-info contains metadata about the machine that is set by
22       the user or administrator.
23
24       Depending on the operating system other configuration files might be
25       checked for machine information as well, however only as fallback.
26
27       You may use hostnamectl(1) to change the settings of this file from the
28       command line.
29

OPTIONS

31       The following machine metadata parameters may be set using
32       /etc/machine-info:
33
34       PRETTY_HOSTNAME=
35           A pretty human-readable UTF-8 machine identifier string. This
36           should contain a name like "Lennart's Laptop" which is useful to
37           present to the user and does not suffer by the syntax limitations
38           of internet domain names. If possible, the internet hostname as
39           configured in /etc/hostname should be kept similar to this one.
40           Example: if this value is "Lennart's Computer" an Internet hostname
41           of "lennarts-computer" might be a good choice. If this parameter is
42           not set, an application should fall back to the Internet host name
43           for presentation purposes.
44
45       ICON_NAME=
46           An icon identifying this machine according to the XDG Icon Naming
47           Specification[1]. If this parameter is not set, an application
48           should fall back to "computer" or a similar icon name.
49
50       CHASSIS=
51           The chassis type. Currently, the following chassis types are
52           defined: "desktop", "laptop", "convertible", "server", "tablet",
53           "handset", "watch", and "embedded", as well as the special chassis
54           types "vm" and "container" for virtualized systems that lack an
55           immediate physical chassis. Note that many systems allow detection
56           of the chassis type automatically (based on firmware information or
57           suchlike). This setting (if set) shall take precedence over
58           automatically detected information and is useful to override
59           misdetected configuration or to manually configure the chassis type
60           where automatic detection is not available.
61
62       DEPLOYMENT=
63           Describes the system deployment environment. One of the following
64           is suggested: "development", "integration", "staging",
65           "production".
66
67       LOCATION=
68           Describes the system location if applicable and known. Takes a
69           human-friendly, free-form string. This may be as generic as
70           "Berlin, Germany" or as specific as "Left Rack, 2nd Shelf".
71

EXAMPLE

73           PRETTY_HOSTNAME="Lennart's Tablet"
74           ICON_NAME=computer-tablet
75           CHASSIS=tablet
76           DEPLOYMENT=production
77

SEE ALSO

79       systemd(1), os-release(5), hostname(5), machine-id(5), hostnamectl(1),
80       systemd-hostnamed.service(8)
81

NOTES

83        1. XDG Icon Naming Specification
84           http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html
85
86
87
88systemd 241                                                    MACHINE-INFO(5)
Impressum