1SYSTEMD.SYSTEM-CREDENTIALS(s7y)stemd.system-credentiaSlYsSTEMD.SYSTEM-CREDENTIALS(7)
2
6 systemd.system-credentials - System Credentials
7
9 System and Service Credentials[1] are data objects that may be passed
10 into booted systems or system services as they are invoked. They can be
11 acquired from various external sources, and propagated into the system
12 and from there into system services. Credentials may optionally be
13 encrypted with a machine-specific key and/or locked to the local TPM2
14 device, and are only decrypted when the consuming service is invoked.
15 System credentials may be used to provision and configure various
17 aspects of the system. Depending on the consuming component credentials
18 are only used on initial invocations or are needed for all invocations.
19 Credentials may be used for any kind of data, binary or text, and may
21 carry passwords, secrets, certificates, cryptographic key material,
22 identity information, configuration, and more.
23
25 firstboot.keymap
26 The console key mapping to set (e.g. "de"). Read by systemd-
27 firstboot(1), and only honoured if no console keymap has been
28 configured before.
29 firstboot.locale, firstboot.locale-messages
31 The system locale to set (e.g. "de_DE.UTF-8"). Read by systemd-
32 firstboot(1), and only honoured if no locale has been configured
33 before. firstboot.locale sets "LANG", while
34 firstboot.locale-message sets "LC_MESSAGES".
35 firstboot.timezone
37 The system timezone to set (e.g. "Europe/Berlin"). Read by
38 systemd-firstboot(1), and only honoured if no system timezone has
39 been configured before.
40 login.issue
42 The data of this credential is written to
43 /etc/issue.d/50-provision.conf, if the file doesn't exist yet.
44 agetty(8) reads this file and shows its contents at the login
45 prompt of terminal logins. See issue(5) for details.
46 Consumed by /usr/lib/tmpfiles.d/provision.conf, see tmpfiles.d(5).
48 login.motd
50 The data of this credential is written to
51 /etc/motd.d/50-provision.conf, if the file doesn't exist yet.
52 pam_motd(8) reads this file and shows its contents as "message of
53 the day" during terminal logins. See motd(5) for details.
54 Consumed by /usr/lib/tmpfiles.d/provision.conf, see tmpfiles.d(5).
56 network.hosts
58 The data of this credential is written to /etc/hosts, if the file
59 doesn't exist yet. See hosts(5) for details.
60 Consumed by /usr/lib/tmpfiles.d/provision.conf, see tmpfiles.d(5).
62 network.dns, network.search_domains
64 DNS server information and search domains. Read by systemd-
65 resolved.service(8).
66 passwd.hashed-password.root, passwd.plaintext-password.root
68 May contain the password (either in UNIX hashed format, or in
69 plaintext) for the root users. Read by both systemd-firstboot(1)
70 and systemd-sysusers(1), and only honoured if no root password has
71 been configured before.
72 passwd.shell.root
74 The path to the shell program (e.g. "/bin/bash") for the root
75 user. Read by both systemd-firstboot(1) and systemd-sysusers(1),
76 and only honoured if no root shell has been configured before.
77 ssh.authorized_keys.root
79 The data of this credential is written to
80 /root/.ssh/authorized_keys, if the file doesn't exist yet. This
81 allows provisioning SSH access for the system's root user.
82 Consumed by /usr/lib/tmpfiles.d/provision.conf, see tmpfiles.d(5).
84 sysusers.extra
86 Additional sysusers.d(5) lines to process during boot.
87 sysctl.extra
89 Additional sysctl.d(5) lines to process during boot.
90 tmpfiles.extra
92 Additional tmpfiles.d(5) lines to process during boot.
93 fstab.extra
95 Additional mounts to establish at boot. For details, see systemd-
96 fstab-generator(8).
97 vconsole.keymap, vconsole.keymap_toggle, vconsole.font,
99 vconsole.font_map, vconsole.font_unimap
100 Console settings to apply, see systemd-vconsole-setup.service(8)
101 for details.
102 getty.ttys.serial, getty.ttys.container
104 Used for spawning additional login prompts, see systemd-getty-
105 generator(8) for details.
106 vmm.notify_socket
108 Configures an sd_notify(3) compatible AF_VSOCK socket the service
109 manager will report status information, ready notification and exit
110 status on. For details see systemd(1).
111 system.machine_id
113 Takes a 128bit ID to initialize the machine ID from (if it is not
114 set yet). Interpreted by the service manager (PID 1). For details
115 see systemd(1).
116
118 systemd(1), kernel-command-line(7), smbios-type-11(7)
119
121 1. System and Service Credentials
122 https://systemd.io/CREDENTIALS
123systemd 254 SYSTEMD.SYSTEM-CREDENTIALS(7)