sdm FirstBoot Service

sdm adds the sdm-firstboot service to each image during Customization. The FirstBoot service implements settings that must be delayed until the target system has actually booted.

The FirstBoot service looks at these settings and implements them as needed:

• Runs custom scripts in /etc/sdm/0piboot/0*-*.sh. See First Boot Scripts for details.
• Optionally (if --bootscripts) executes custom scripts in /usr/local/sdm/thispi/1piboot/0*-*.sh. sdm Phase 0 copies these files from /usr/local/sdm/1piboot on the running system.
• Sets keyboard layout
• Sets WiFi Country
• Resets the system console boot behaviour (See NOTE below).

Note that the hostname does not need to be set since you typically set it when you burn the disk with sdm.

After all First System Boot processing has been done, FirstBoot waits until the system boot process has fully completed. If --restart or --reboot were specified (recommended!), FirstBoot will then restart the system.

First Boot Automatic System Restart is useful for a couple reasons:

• if access to the system requires a configuration setting modified during the First Boot. A restart ensures that all configuration settings are fully enabled.
• You want it to reboot to make it easier to ensure that your configuration and services are as desired
• You want the system to be fully operational so you can get started!

NOTE: If --restart is specified on RasPiOS Full with Desktop (or RasPiOS Lite with any of lightdm, xdm, or wdm), sdm changes the boot_behaviour to B1 (Text console with no autologin) so that the sdm FirstBoot messages are visible. In this case the boot_behaviour is reset to B4 (Graphical Desktop with autologin) for all subsequent reboots, unless the command line included --plugin raspiconfig:"boot_behaviour:xx" command switch was specified.