PIBOOTCTL-SAVE(1) pibootctl PIBOOTCTL-SAVE(1)

pibootctl-save - pibootctl manual

pibootctl save [-h] [-f] name


Store the current boot configuration under a given name.

The name to save the current boot configuration under; can include any characters legal in a filename

Show a brief help page for the command.

Overwrite an existing configuration, if one exists

The save command is used to take a backup of the current boot configuration. In practice this creates a PKZIP <https://en.wikipedia.org/wiki/Zip_(file_format)> of the files that make up the boot configuration (config.txt et al.), and places it under the configured directory on the boot partition (usually pibootctl):

$ ls /boot/pibootctl
$ sudo pibootctl save foo
$ ls /boot/pibootctl
foo.zip


Note that by default, you cannot overwrite saved configurations, but this can be overridden with the --force option:

$ sudo pibootctl save foo
[Errno 17] File exists: 'foo.zip'
$ sudo pibootctl save -f foo


In the event that your system is rendered un-bootable, a boot configuration can be easily restored by extracting the PKZIP of a saved configuration into the boot partition (over-writing files as necessary). Alternatively you can use the load command (if the system can boot). The list command can be used to display all currently stored configurations.

Dave Jones

2019-2020 Dave Jones

September 14, 2020 0.5.2