systemd-machine-id-setup man page
systemd-machine-id-setup — Initialize the machine ID in /etc/machine-id
systemd-machine-id-setup may be used by system installer tools to initialize the machine ID stored in
/etc/machine-id at install time with a randomly generated ID. See machine-id(5) for more information about this file.
This tool will execute no operation if
/etc/machine-id is already initialized.
If a valid D-Bus machine ID is already configured for the system, the D-Bus machine ID is copied and used to initialize the machine ID in
If run inside a KVM virtual machine and a UUID is passed via the
-uuid option, this UUID is used to initialize the machine ID instead of a randomly generated one. The caller must ensure that the UUID passed is sufficiently unique and is different for every booted instanced of the VM.
Similar, if run inside a Linux container environment and a UUID is set for the container this is used to initialize the machine ID. For details see the documentation of the Container Interface.
Use systemd-firstboot(1) to initialize the machine ID on mounted (but not booted) system images.
The following options are understood:
- Takes a directory path as an argument. All paths will be prefixed with the given alternate
rootpath, including config search paths.
- -h, --help
- Print a short help text and exit.
- Print a short version string and exit.
On success, 0 is returned, a non-zero failure code otherwise.
systemd(1), machine-id(5), dbus-uuidgen(1), systemd-firstboot(1)
lvmsystemid(7), machine-id(5), systemd.directives(7), systemd-firstboot(1), systemd.index(7), systemd-machine-id-commit(1), systemd-machine-id-commit.service(8).
Explore man page connections for systemd-machine-id-setup(1).