1MACHINE-INFO(5) machine-info MACHINE-INFO(5)
2
3
4
6 machine-info - Local machine information file
7
9 /etc/machine-info
10
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. The settings configured here have the
23 highest precedence. When not set, appropriate values may be determined
24 automatically, based on the information about the hardware or other
25 configuration files. It is thus completely fine for this file to not be
26 present.
27
28 You may use hostnamectl(1) to change the settings of this file from the
29 command line.
30
32 The following machine metadata parameters may be set using
33 /etc/machine-info:
34
35 PRETTY_HOSTNAME=
36 A pretty human-readable UTF-8 machine identifier string. This
37 should contain a name like "Lennart's Laptop" which is useful to
38 present to the user and does not suffer by the syntax limitations
39 of internet domain names. If possible, the internet hostname as
40 configured in /etc/hostname should be kept similar to this one.
41 Example: if this value is "Lennart's Computer" an Internet hostname
42 of "lennarts-computer" might be a good choice. If this parameter is
43 not set, an application should fall back to the Internet hostname
44 for presentation purposes.
45
46 ICON_NAME=
47 An icon identifying this machine according to the XDG Icon Naming
48 Specification[1]. If this parameter is not set, an application
49 should fall back to "computer" or a similar icon name.
50
51 CHASSIS=
52 The chassis type. Currently, the following chassis types are
53 defined: "desktop", "laptop", "convertible", "server", "tablet",
54 "handset", "watch", and "embedded", as well as the special chassis
55 types "vm" and "container" for virtualized systems that lack an
56 immediate physical chassis.
57
58 Note that most systems allow detection of the chassis type
59 automatically (based on firmware information or suchlike). This
60 setting should only be used to override a misdetection or to
61 manually configure the chassis type where automatic detection is
62 not available.
63
64 DEPLOYMENT=
65 Describes the system deployment environment. One of the following
66 is suggested: "development", "integration", "staging",
67 "production".
68
69 LOCATION=
70 Describes the system location if applicable and known. Takes a
71 human-friendly, free-form string. This may be as generic as
72 "Berlin, Germany" or as specific as "Left Rack, 2nd Shelf".
73
75 PRETTY_HOSTNAME="Lennart's Tablet"
76 ICON_NAME=computer-tablet
77 CHASSIS=tablet
78 DEPLOYMENT=production
79
81 systemd(1), os-release(5), hostname(5), machine-id(5), hostnamectl(1),
82 systemd-hostnamed.service(8)
83
85 1. XDG Icon Naming Specification
86 http://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html
87
88
89
90systemd 248 MACHINE-INFO(5)