1MACHINE-INFO(5) machine-info MACHINE-INFO(5)
2
6 machine-info - Local machine information file
7
9 /etc/machine-info
10
12 The /etc/machine-info file contains machine metadata.
13 The format of machine-info is a newline-separated list of
15 environment-like shell-compatible variable assignments, ignoring
16 comments and empty lines. It is possible to source the configuration
17 from shell scripts, however, beyond mere variable assignments no shell
18 features are supported, allowing applications to read the file without
19 implementing a shell compatible execution engine. See os-release(5) for
20 a detailed description of the format.
21 /etc/machine-info contains metadata about the machine that is set by
23 the user or administrator. The settings configured here have the
24 highest precedence. When not set, appropriate values may be determined
25 automatically, based on the information about the hardware or other
26 configuration files. It is thus completely fine for this file to not be
27 present.
28 You may use hostnamectl(1) to change the settings of this file from the
30 command line.
31
33 The following machine metadata parameters may be set using
34 /etc/machine-info:
35 PRETTY_HOSTNAME=
37 A pretty human-readable UTF-8 machine identifier string. This
38 should contain a name like "Lennart's Laptop" which is useful to
39 present to the user and does not suffer by the syntax limitations
40 of internet domain names. If possible, the internet hostname as
41 configured in /etc/hostname should be kept similar to this one.
42 Example: if this value is "Lennart's Computer" an Internet hostname
43 of "lennarts-computer" might be a good choice. If this parameter is
44 not set, an application should fall back to the Internet hostname
45 for presentation purposes.
46 ICON_NAME=
48 An icon identifying this machine according to the XDG Icon Naming
49 Specification[1]. If this parameter is not set, an application
50 should fall back to "computer" or a similar icon name.
51 CHASSIS=
53 The chassis type. Currently, the following chassis types are
54 defined: "desktop", "laptop", "convertible", "server", "tablet",
55 "handset", "watch", and "embedded", as well as the special chassis
56 types "vm" and "container" for virtualized systems that lack an
57 immediate physical chassis.
58 Note that most systems allow detection of the chassis type
60 automatically (based on firmware information or suchlike). This
61 setting should only be used to override a misdetection or to
62 manually configure the chassis type where automatic detection is
63 not available.
64 DEPLOYMENT=
66 Describes the system deployment environment. One of the following
67 is suggested: "development", "integration", "staging",
68 "production".
69 LOCATION=
71 Describes the system location if applicable and known. Takes a
72 human-friendly, free-form string. This may be as generic as
73 "Berlin, Germany" or as specific as "Left Rack, 2nd Shelf".
74 HARDWARE_VENDOR=
76 Specifies the hardware vendor. If unspecified, the hardware vendor
77 set in DMI or hwdb(7) will be used.
78 HARDWARE_MODEL=
80 Specifies the hardware model. If unspecified, the hardware model
81 set in DMI or hwdb(7) will be used.
82
84 PRETTY_HOSTNAME="Lennart's Tablet"
85 ICON_NAME=computer-tablet
86 CHASSIS=tablet
87 DEPLOYMENT=production
88
90 systemd(1), os-release(5), hostname(5), machine-id(5), hostnamectl(1),
91 systemd-hostnamed.service(8)
92
94 1. XDG Icon Naming Specification
95 https://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html
96systemd 253 MACHINE-INFO(5)