OS Manuals

/usr/bin/systemd-firstboot

Initialize basic system settings on or before the first boot-up of a system

From systemd-firstboot 262.2-r1 (os), captured 2026-11-05 by running systemd-firstboot --help (exit 0). permalink

> systemd-firstboot [OPTION…]

Configure basic settings of the system.

Options:
  -h --help                        Show this help
     --version                     Show package version
     --root=PATH                   Operate on an alternate filesystem root
     --image=PATH                  Operate on disk image as filesystem root
     --image-policy=POLICY         Specify disk image dissection policy
     --locale=LOCALE               Set primary locale (LANG=)
     --locale-messages=LOCALE      Set message locale (LC_MESSAGES=)
     --keymap=KEYMAP               Set keymap
     --timezone=TIMEZONE           Set timezone
     --hostname=NAME               Set hostname
     --setup-machine-id            Set a random machine ID
     --machine-id=ID               Set specified machine ID
     --machine-tags=TAG[:…]        Set machine tags
     --root-password=PASSWORD      Set root password from plaintext password
     --root-password-file=FILE     Set root password from file
     --root-password-hashed=HASH   Set root password from hashed password
     --root-shell=SHELL            Set root shell
     --kernel-command-line=CMDLINE Set kernel command line
     --prompt-locale               Prompt the user for locale settings
     --prompt-keymap               Prompt the user for keymap settings
     --prompt-keymap-auto          Prompt the user for keymap settings if invoked on local console
     --prompt-timezone             Prompt the user for timezone
     --prompt-hostname             Prompt the user for hostname
     --prompt-root-password        Prompt the user for root password
     --prompt-root-shell           Prompt the user for root shell
     --prompt                      Prompt for all of the above
     --copy-locale                 Copy locale from host
     --copy-keymap                 Copy keymap from host
     --copy-timezone               Copy timezone from host
     --copy-root-password          Copy root password from host
     --copy-root-shell             Copy root shell from host
     --copy                        Copy all of the above
     --force                       Overwrite existing files
     --delete-root-password        Delete root password
     --welcome=BOOL                Whether to show the welcome text
     --chrome=BOOL                 Whether to show a color bar at top and bottom of terminal
     --mute-console=BOOL           Whether to disallow kernel/PID 1 writes to the console while
                                   running
     --reset                       Remove existing files

See the systemd-firstboot(1) man page for details.
Options (37)
OptionDescriptionSource
-h --helpShow this helphelp
--versionShow package versionhelp
--root PATHOperate on an alternate filesystem roothelp
--image PATHOperate on disk image as filesystem roothelp
--image-policy POLICYSpecify disk image dissection policyhelp
--locale LOCALESet primary locale (LANG=)help
--locale-messages LOCALESet message locale (LC_MESSAGES=)help
--keymap KEYMAPSet keymaphelp
--timezone TIMEZONESet timezonehelp
--hostname NAMESet hostnamehelp
--setup-machine-idSet a random machine IDhelp
--machine-id IDSet specified machine IDhelp
--machine-tags TAG[:…Set machine tagshelp
--root-password PASSWORDSet root password from plaintext passwordhelp
--root-password-file FILESet root password from filehelp
--root-password-hashed HASHSet root password from hashed passwordhelp
--root-shell SHELLSet root shellhelp
--prompt-localePrompt the user for locale settingshelp
--prompt-keymapPrompt the user for keymap settingshelp
--prompt-keymap-autoPrompt the user for keymap settings if invoked on local consolehelp
--prompt-timezonePrompt the user for timezonehelp
--prompt-hostnamePrompt the user for hostnamehelp
--prompt-root-passwordPrompt the user for root passwordhelp
--prompt-root-shellPrompt the user for root shellhelp
--promptPrompt for all of the abovehelp
--copy-localeCopy locale from hosthelp
--copy-keymapCopy keymap from hosthelp
--copy-timezoneCopy timezone from hosthelp
--copy-root-passwordCopy root password from hosthelp
--copy-root-shellCopy root shell from hosthelp
--copyCopy all of the abovehelp
--forceOverwrite existing fileshelp
--delete-root-passwordDelete root passwordhelp
--welcome BOOLWhether to show the welcome texthelp
--chrome BOOLWhether to show a color bar at top and bottom of terminalhelp
--mute-console BOOLWhether to disallow kernel/PID 1 writes to the console while runninghelp
--resetRemove existing fileshelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.