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-message
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 vconsole.keymap, vconsole.keymap_toggle, vconsole.font,
95 vconsole.font_map, vconsole.font_unimap
96 Console settings to apply, see systemd-vconsole-setup.service(8)
97 for details.
98 vmm.notify_socket
100 Contains a AF_VSOCK or AF_UNIX address where to send a READY=1
101 notification datagram when the system has finished booting. See
102 sd_notify(3) for more information. Note that in case the hypervisor
103 does not support SOCK_DGRAM over AF_VSOCK, SOCK_SEQPACKET will be
104 tried instead. The credential payload for AF_VSOCK should be in the
105 form "vsock:CID:PORT".
106 This feature is useful for hypervisors/VMMs or other processes on
108 the host to receive a notification via VSOCK when a virtual machine
109 has finished booting.
110
112 systemd(1), kernel-command-line(7)
113
115 1. System and Service Credentials
116 https://systemd.io/CREDENTIALS
117systemd 253 SYSTEMD.SYSTEM-CREDENTIALS(7)