Diskless Mode: Difference between revisions

From Alpine Linux
(added additional links)
m (minor rewording and added wikilinks)
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
In Diskless mode, the entire operating system with all applications are first loaded into RAM (<code>tmpfs</code>) and then only run from there. This is also the method used to boot the Alpine Linux <Code>ISO9660</Code> filesystem based read-only [[Installation#Preparing_installation_media|installation media]]. Alpine Linux can be installed and configured so that the system continue to boot in diskless mode, if "disk=none" is specified while running the <code>[[Alpine_setup_scripts#setup-alpine|setup-alpine]]</code> script.  
In Diskless mode, the entire operating system with all applications are first loaded into RAM (<code>tmpfs</code>) and then only run from there. This is also the method used to boot the Alpine Linux <Code>ISO9660</Code> filesystem based read-only [[Installation#Preparing_installation_media|installation media]].


Diskless mode is extremely fast and can save on unnecessary disk spin-ups, power, and wear and suitable for servers. It is similar to what other linux distributions may call a "frugal" install or boot using a "toram" option. In Diskless mode, the root filesystem is mounted as <code>tmpfs</code> which allocates half of physical RAM by default.
Diskless mode is extremely fast and can save on unnecessary disk spin-ups, power, and wear and suitable for servers. It is similar to what other linux distributions may call a "frugal" install or boot using a "toram" option.
 
{{Tip| The allocation for root filesystem may be customized at boot by setting [https://gitlab.alpinelinux.org/alpine/mkinitfs/-/blob/54bae0769080710e0769370a7bf3e0e158eec152/initramfs-init.in#L809-813 kernel parameter] as <code>rootflags{{=}}size{{=}}300M</code>, or temporarily after boot by issuing <code>mount -o remount,size{{=}}300M /</code>.}}


Alpine Linux provides [[Alpine_local_backup|Local Backup Utility]]({{ic|lbu}}) that allows custom configurations and package installations to be optionally preserved or made to "persist" across reboots as [[#Apkovl|apkovl]] files. If additional or updated packages have been added to the system, these may also be made available for automatic (re)installation during the boot phase without any (re)downloading, by enabling a [[#Local package cache|local package cache]].
Alpine Linux provides [[Alpine_local_backup|Local Backup Utility]]({{ic|lbu}}) that allows custom configurations and package installations to be optionally preserved or made to "persist" across reboots as [[#Apkovl|apkovl]] files. If additional or updated packages have been added to the system, these may also be made available for automatic (re)installation during the boot phase without any (re)downloading, by enabling a [[#Local package cache|local package cache]].


== Apkovl ==
== Diskless installation ==
 
The local configuration or system state is saved  as APK Overlay ('''apkovl''') file to a backup location by the {{ic|lbu}}and loaded when booting. The filename for the '''apkovl'''  file is of the format <Code><hostname>.apkovl.tar.gz</Code> and is stored in a location whose path is defined in {{Path|/etc/lbu/lbu.conf}} file. Apkovl file stores all configuration files that have changed from the default ones. The contents from the Apkovl file are overlaid on top of the contents of the base image. In Diskless mode, for every change made to the running system to persist across reboot, the command {{ic|lbu commit}} must be issued to update the apkovl file.


== Diskless installation ==
When running the <code>[[Alpine_setup_scripts#setup-alpine|setup-alpine]]</code> script, if "disk=none" is specified, then Alpine Linux will continue to run in diskless mode. It invokes <code>[[Alpine_setup_scripts#setup-lbu|setup-lbu]]</code>  and <code>[[Alpine_setup_scripts#setup-apkcache|setup-apkcache]]</code> to use any available writable filesystem on any media other than the read-only [[Installation#Preparing_installation_media|installation media]] for saving the configuration settings as [[#Apkovl|apkovl]] file and [[#Local package cache|local package cache]].


=== Customizable boot device ===
{{Tip|For Diskless installations, create a [[Create a Bootable Device|Customizable boot device]] instead of a read-only installation media.}}


A [[Create_a_Bootable_Device|Customizable boot device]] allows Alpine Linux to boot and run in Diskless mode from a partition with a writable filesystem on USB-Stick/CompactFlash/SDCard or SSD/NVMe harddisk. The [[#Apkovl|apkovl]] file(s) and [[#Local package cache|local package cache]] can also be stored in this customizable boot device.
Complete the below preparatory steps depending on the available persistent storage option.  


=== Using an internal disk for persistent storage ===
=== Using an internal disk for persistent storage ===


Alpine Linux setup script <code>setup-alpine</code> uses <code>[[Alpine_setup_scripts#setup-lbu|setup-lbu]]</code> script to save local configs as [[#Apkovl|apkovl]] file to any available writable filesystem on any media other than the read-only [[Installation#Preparing_installation_media|installation media]]. Due to Bug: [https://gitlab.alpinelinux.org/alpine/alpine-conf/-/issues/10473 #10473] storing local configs on '''internal disks''' requires manual steps, i.e making an entry in {{Path|/etc/fstab}}, create mountpoint, and mount the partition before running <code>setup-alpine</code> script.  
Due to Bug: [https://gitlab.alpinelinux.org/alpine/alpine-conf/-/issues/10473 #10473] storing local configs on '''internal disks''' requires manual steps, i.e making an entry in {{Path|/etc/fstab}}, create mountpoint, and mount the partition before running <code>setup-alpine</code> script.  


# In this case, boot the target diskless system from the [[Installation#Preparing_installation_media|installation media]] and do not proceed after the [[Installation#Boot_Process|boot process]] stage.  
# In this case, boot the target diskless system from the [[Installation#Preparing_installation_media|installation media]] and do not proceed after the [[Installation#Boot_Process|boot process]] stage.  
Line 31: Line 27:
<!-- Mounting read-only is possible, because the [[Alpine_local_backup|lbu tools]] can temporarily remount it writable for their operation. -->
<!-- Mounting read-only is possible, because the [[Alpine_local_backup|lbu tools]] can temporarily remount it writable for their operation. -->
# Mount the partitions listed in {{Path|/etc/fstab}}:{{Cmd|# <code>mount -a</code>}}  
# Mount the partitions listed in {{Path|/etc/fstab}}:{{Cmd|# <code>mount -a</code>}}  
# Verify that the changes have been applied correctly by looking at the output of {{Codeline|<code>mount</code>}}. Proceed to [[#Finishing diskless installation|Finishing diskless installation]] section without rebooting the computer.
# Verify that the changes have been applied correctly by looking at the output of {{Cmd|$ <code>mount</code>}}  
# Proceed to [[#Finishing diskless installation|Finishing diskless installation]] section without rebooting the computer.
 
=== Using customizable boot device for persistent storage ===
 
A [[Create_a_Bootable_Device|Customizable boot device]] allows Alpine Linux to boot and run in Diskless mode from a partition with a writable filesystem on USB-Stick/CompactFlash/SDCard or SSD/NVMe harddisk. The [[#Apkovl|apkovl]] file(s) and [[#Local package cache|local package cache]] can be stored in this customizable boot device and no other storage is required.
 
# Boot using the [[Create_a_Bootable_Device|Customizable boot device]].
# Find out where the customizable boot device is mounted, the location could vary.{{Cmd|<nowiki># mount | grep /media
/dev/sdXY on /media/sdXY type vfat (rw,relatime,fmask=0022,dmask=0022,codepage=437,iocharset=utf8,shortname=mixed,errors=remount-ro)
</nowiki>}}
# Mount the customizable boot device in rw mode, if required. {{Cmd|# mount -o remount,rw /media/sdXY}}
<!--
# Issue the below commands to create a directory for [[Local_APK_cache|Local Package Cache]]. {{Cmd|<nowiki># mkdir /media/sda1/cache
# setup-apkcache /media/sda1/cache
# ls -l /etc/apk/cache
lrwxrwxrwx    1 root    root            17 Oct 19 13:16 /etc/apk/cache -> /media/sda1/cache
</nowiki>}}-->
# Proceed to [[#Finishing diskless installation|Finishing diskless installation]] section without rebooting the computer.


=== Finishing diskless installation ===
=== Finishing diskless installation ===


# If <code>setup-alpine</code> has not run before, follow the [[Installation#Installation_Step_Details|Installation steps]] to complete the [[Installation#Base_configuration|base configuration]]. The [[#Using an internal disk for persistent storage|above preparation]] should now enable you to choose the partition('''sdXY''') for saving the local configs and package cache. If asked, there is no need to first unmount the partition, that would only be needed to allow installing on its parent disk. When the ''' Disk & Install''' option appears, accept the choices as follows:{{Cmd|<nowiki>Which disk(s) would you like to use? (or '?' for help or 'none') [none]  
# If <code>setup-alpine</code> has not run before, follow the [[Installation#Installation_Step_Details|Installation steps]] to complete until the '''Disk & Install''' option appears.
<!--If asked, there is no need to first unmount the partition, that would only be needed to allow installing on its parent disk.-->
#* When the ''' Disk & Install''' option appears, the preparatory steps done earlier for [[#Using an internal disk for persistent storage|internal disk]] or [[#Using customizable boot device for persistent storage|customizable boot device]] should now enable you to choose the partition('''sdXY''') for saving the local configs and package cache. So accept the choices as follows:{{Cmd|<nowiki>Which disk(s) would you like to use? (or '?' for help or 'none') [none]  
Enter where to store configs ('floppy', 'sdXY', 'usb' or 'none') [sdXY]:  
Enter where to store configs ('floppy', 'sdXY', 'usb' or 'none') [sdXY]:  
Enter apk cache directory (or '?' or 'none') [/media/sdXY/cache]:</nowiki>}}
Enter apk cache directory (or '?' or 'none') [/media/sdXY/cache]:</nowiki>}}
# If <code>setup-alpine</code> has already been run to configure the diskless system, the storage and package cache settings can be configured as follows:{{cmd|<nowiki># setup-lbu sdXY
# If <code>setup-alpine</code> has already been run to configure the diskless system, the storage and package cache settings can be configured using the <code>[[Alpine_setup_scripts#setup-lbu|setup-lbu]]</code> and <code>[[Alpine_setup_scripts#setup-apkcache|setup-apkcache]]</code> as follows:{{cmd|<nowiki># setup-lbu sdXY
# mkdir /media/sdXY/cache
# mkdir /media/sdXY/cache
# setup-apkcache /media/sdXY/cache</nowiki>}}
# setup-apkcache /media/sdXY/cache</nowiki>}}
# Now the diskless installation can be considered complete. Always remember to commit changes to disk.{{Cmd|# lbu commit}}
# After the installer finished one can see how many created/modified files are detected and will be added to the backup:{{Cmd|<nowiki># lbu status
# lbu status | wc -l
59
</nowiki>}}
# Now Commit all the changes using the command:{{Cmd|# lbu commit}}
# Verify that the above command has created the [[#Apkovl|apkovl]] file i.e <Code><hostname>.apkovl.tar.gz</Code> as follows:{{Cmd|<nowiki>ls -l /media/sda1/*apkovl.tar.gz
-rwxr-xr-x    1 root    root          9591 Oct 19 15:23 /media/sda1/foo.apkovl.tar.gz
</nowiki>}}
# Now the diskless installation can be considered complete.


== Local package cache ==
== Configuration ==
 
Refer to the following sections related to running a Diskless installation.
 
=== Modifying root filesystem size ===
 
In Diskless mode, the root filesystem is mounted as <code>tmpfs</code>. By default rootfs is allocated 50% of available RAM (without swap). This may be adjusted to arbitrary value (like 300MB) at boot by setting [https://gitlab.alpinelinux.org/alpine/mkinitfs/-/blob/54bae0769080710e0769370a7bf3e0e158eec152/initramfs-init.in#L809-813 kernel parameter] as <code>rootflags{{=}}size{{=}}300M</code>, or temporarily after boot by issuing <code>mount -o remount,size{{=}}300M /</code>.
 
=== Local package cache ===
{{Main|Local APK cache}}
{{Main|Local APK cache}}
When Alpine Linux boots in Diskless Mode, the remote repositories will not be available until after networking has started. That means newer or extra packages not in your local boot media's squashfs image would not be available after a reboot, unless they were made available as [[Local APK cache|local package cache]] on a writable local storage device. The local package cache can be on the same partition as the '''apkovl''' file.
When Alpine Linux boots in Diskless Mode, the remote repositories will not be available until after networking has started. That means newer or extra packages not in your local boot media's squashfs image would not be available after a reboot, unless they were made available as [[Local APK cache|local package cache]] on a writable local storage device. The local package cache can be on the same partition as the '''apkovl''' file.
=== Apkovl ===
The local configuration or system state is saved  as APK Overlay ('''apkovl''') file to a backup location by the {{ic|lbu}}and loaded when booting. The filename for the '''apkovl'''  file is of the format <Code><hostname>.apkovl.tar.gz</Code> and is stored in a location whose path is defined in {{Path|/etc/lbu/lbu.conf}} file. Apkovl file stores all configuration files that have changed from the default ones. The contents from the Apkovl file are overlaid on top of the contents of the base image. In Diskless mode, for every change made to the running system to persist across reboot, the command {{ic|lbu commit}} must be issued to update the apkovl file.
==== Loading apkovl from webserver ====
If a read-only installation media is used, it can remain the only boot device for the "diskless" system by saving the running state i.e [[#Apkovl|apkovl]] file to a webserver, and have these automatically loaded when booting from the boot device. The Alpine linux boot process supports passing boot parameters to load [[#Apkovl|apkovl]] file from a webserver, by supplying a custom url with the {{ic|apkovl}} kernel boot parameter. If you don't have a web server you can run busybox's httpd temporarily to serve an .apkovl - <code>busybox httpd -p 127.0.0.1:80</code>.


== Upgrading a diskless system ==
== Upgrading a diskless system ==


When Alping Linux runs in "diskless" or "data" disk mode, Upgrading requires few extra steps in addition to the regular [[Alpine_Package_Keeper#Upgrade_a_Running_System|upgrade steps]].
[[Alpine_Package_Keeper#Upgrade_a_Running_System|Upgrading a running]] system with [[Diskless Mode|diskless]] or [[Data Disk Mode|Data disk]] mode for regular package update requires running the below command from [[Alpine_local_backup|Local Backup Utility]] after every package update:{{Cmd|# lbu commit}}


If booting a "diskless" system from a read-only device, or as an iso image on writable media, it's not possible to update the boot files (kernel, modules, firmware, ...) that reside on that device.
For upgrading the kernel, with its modules and firmware files use [[Diskless Mode#update-kernel script|update-kernel]] script. For upgrading  [[Diskless Mode|diskless]] or [[Data Disk Mode|Data disk]] installations to a new release branch refer  [[Upgrading Alpine Linux to a new release branch#Upgrading diskless and data disk mode installs to latest release|Upgrading diskless and data disk mode installs to latest release]].


For [[Create_a_Bootable_Device|customizable boot device]], It is possible to update the boot files. However, even then, the kernel, with its modules and firmware files, can still not be updated directly through regular packages updates. Instead, there is the <code>update-kernel</code> script that can generate initfs images and install them together with upgraded kernels.
=== update-kernel script ===
 
When kernel packages with its modules and firmware packages are upgraded, the <code>update-kernel</code> script generates initfs images and installs them together with upgraded kernel and updates the boot files in persistent storages like [[Create_a_Bootable_Device|customizable boot device]].


* Before upgrading, install the {{Pkg|mkinitfs}} package as this is required for the generation of the initial filesystem used during boot as follows: {{cmd|# apk add mkinitfs}}
* Before upgrading, install the {{Pkg|mkinitfs}} package as this is required for the generation of the initial filesystem used during boot as follows: {{cmd|# apk add mkinitfs}}
Line 70: Line 112:
See <code>update-kernel --help</code> for options to manually add additional module or firmware packages.
See <code>update-kernel --help</code> for options to manually add additional module or firmware packages.


== Loading apkovl from webserver ==
== Documentation on kernel options ==
 
The read-only installation media can remain the only boot device for the "diskless" system by saving the running state to an [[#Apkovl|apkovl]] file to a webserver, and have these automatically loaded when booting from the boot device. The Alpine linux boot process supports passing boot parameters to load [[#Apkovl|apkovl]] file from a webserver, by supplying a custom url with the {{ic|apkovl}} kernel boot parameter. If you don't have a web server you can run busybox's httpd temporarily to serve an .apkovl - <code>busybox httpd -p 127.0.0.1:80</code>.
 
== Kernel options ==


Documentation about kernel command line options regarding diskless mode will be available after installing the documentation sub-package {{Pkg|mkinitfs-doc}}:  
Documentation about kernel command line options regarding diskless mode can be accessed by installing the documentation sub-package {{Pkg|mkinitfs-doc}} and running the command {{Cmd|man mkinitfs-bootparam}}  


{{Cmd|man mkinitfs-bootparam}} <Pre>
<Pre>
       If no root= parameter is given, the initramfs will build a live system
       If no root= parameter is given, the initramfs will build a live system
       in memory from scratch. This is also called diskless mode.
       in memory from scratch. This is also called diskless mode.

Latest revision as of 10:27, 29 September 2025

In Diskless mode, the entire operating system with all applications are first loaded into RAM (tmpfs) and then only run from there. This is also the method used to boot the Alpine Linux ISO9660 filesystem based read-only installation media.

Diskless mode is extremely fast and can save on unnecessary disk spin-ups, power, and wear and suitable for servers. It is similar to what other linux distributions may call a "frugal" install or boot using a "toram" option.

Alpine Linux provides Local Backup Utility(lbu) that allows custom configurations and package installations to be optionally preserved or made to "persist" across reboots as apkovl files. If additional or updated packages have been added to the system, these may also be made available for automatic (re)installation during the boot phase without any (re)downloading, by enabling a local package cache.

Diskless installation

When running the setup-alpine script, if "disk=none" is specified, then Alpine Linux will continue to run in diskless mode. It invokes setup-lbu and setup-apkcache to use any available writable filesystem on any media other than the read-only installation media for saving the configuration settings as apkovl file and local package cache.

Tip: For Diskless installations, create a Customizable boot device instead of a read-only installation media.

Complete the below preparatory steps depending on the available persistent storage option.

Using an internal disk for persistent storage

Due to Bug: #10473 storing local configs on internal disks requires manual steps, i.e making an entry in /etc/fstab, create mountpoint, and mount the partition before running setup-alpine script.

  1. In this case, boot the target diskless system from the installation media and do not proceed after the boot process stage.
  2. If necessary partition(s) are unavailable, manually create a partition using fdisk. In the below steps, we will use /dev/sdXY as partition number. Adjust the partition identifier as per the output of blkid
    • Due to Bug: #11589. The APKOVL loading of diskless setups doesn't work on btrfs and xfs filesystems, or nvme-based devices. So use only ext4 filesystem partitions on classic drives to store diskless mode states.
    • mkfs.ext4 creates ext4 filesystem with 64bit feature enabled by default, but extlinux may not be able to boot with that due to Issue #14895. You may need to add "-O ^64bit" to mkfs.ext4 to circumvent this. The below command creates an ext4 partition with disabled journaling, to reduce write operations and allow the disk to spin down after the .apkovl and the packages have been read from the partition during the boot. Install package e2fsprogs using command apk add e2fsprogs, if the command mkfs.ext4 is not available.

    # mkfs.ext4 -O ^has_journal,^64bit /dev/sdXY

  3. Due to a bug, the partition can not be mounted to /boot. Configure the /etc/fstab to mount the writable partition to /media/sdXY instead of /boot i.e. conforming to the hot/cold-plug mountpoints.

    # mkdir /media/sdXY

    # echo "/dev/sdXY /media/sdXY ext4 noatime,ro 0 0" >> /etc/fstab

  4. Mount the partitions listed in /etc/fstab:

    # mount -a

  5. Verify that the changes have been applied correctly by looking at the output of

    $ mount

  6. Proceed to Finishing diskless installation section without rebooting the computer.

Using customizable boot device for persistent storage

A Customizable boot device allows Alpine Linux to boot and run in Diskless mode from a partition with a writable filesystem on USB-Stick/CompactFlash/SDCard or SSD/NVMe harddisk. The apkovl file(s) and local package cache can be stored in this customizable boot device and no other storage is required.

  1. Boot using the Customizable boot device.
  2. Find out where the customizable boot device is mounted, the location could vary.

    # mount | grep /media /dev/sdXY on /media/sdXY type vfat (rw,relatime,fmask=0022,dmask=0022,codepage=437,iocharset=utf8,shortname=mixed,errors=remount-ro)

  3. Mount the customizable boot device in rw mode, if required.

    # mount -o remount,rw /media/sdXY

  4. Proceed to Finishing diskless installation section without rebooting the computer.

Finishing diskless installation

  1. If setup-alpine has not run before, follow the Installation steps to complete until the Disk & Install option appears.
    • When the Disk & Install option appears, the preparatory steps done earlier for internal disk or customizable boot device should now enable you to choose the partition(sdXY) for saving the local configs and package cache. So accept the choices as follows:

      Which disk(s) would you like to use? (or '?' for help or 'none') [none] Enter where to store configs ('floppy', 'sdXY', 'usb' or 'none') [sdXY]: Enter apk cache directory (or '?' or 'none') [/media/sdXY/cache]:

  2. If setup-alpine has already been run to configure the diskless system, the storage and package cache settings can be configured using the setup-lbu and setup-apkcache as follows:

    # setup-lbu sdXY # mkdir /media/sdXY/cache # setup-apkcache /media/sdXY/cache

  3. After the installer finished one can see how many created/modified files are detected and will be added to the backup:

    # lbu status # lbu status | wc -l 59

  4. Now Commit all the changes using the command:

    # lbu commit

  5. Verify that the above command has created the apkovl file i.e <hostname>.apkovl.tar.gz as follows:

    ls -l /media/sda1/*apkovl.tar.gz -rwxr-xr-x 1 root root 9591 Oct 19 15:23 /media/sda1/foo.apkovl.tar.gz

  6. Now the diskless installation can be considered complete.

Configuration

Refer to the following sections related to running a Diskless installation.

Modifying root filesystem size

In Diskless mode, the root filesystem is mounted as tmpfs. By default rootfs is allocated 50% of available RAM (without swap). This may be adjusted to arbitrary value (like 300MB) at boot by setting kernel parameter as rootflags=size=300M, or temporarily after boot by issuing mount -o remount,size=300M /.

Local package cache

When Alpine Linux boots in Diskless Mode, the remote repositories will not be available until after networking has started. That means newer or extra packages not in your local boot media's squashfs image would not be available after a reboot, unless they were made available as local package cache on a writable local storage device. The local package cache can be on the same partition as the apkovl file.

Apkovl

The local configuration or system state is saved as APK Overlay (apkovl) file to a backup location by the lbuand loaded when booting. The filename for the apkovl file is of the format <hostname>.apkovl.tar.gz and is stored in a location whose path is defined in /etc/lbu/lbu.conf file. Apkovl file stores all configuration files that have changed from the default ones. The contents from the Apkovl file are overlaid on top of the contents of the base image. In Diskless mode, for every change made to the running system to persist across reboot, the command lbu commit must be issued to update the apkovl file.

Loading apkovl from webserver

If a read-only installation media is used, it can remain the only boot device for the "diskless" system by saving the running state i.e apkovl file to a webserver, and have these automatically loaded when booting from the boot device. The Alpine linux boot process supports passing boot parameters to load apkovl file from a webserver, by supplying a custom url with the apkovl kernel boot parameter. If you don't have a web server you can run busybox's httpd temporarily to serve an .apkovl - busybox httpd -p 127.0.0.1:80.

Upgrading a diskless system

Upgrading a running system with diskless or Data disk mode for regular package update requires running the below command from Local Backup Utility after every package update:

# lbu commit

For upgrading the kernel, with its modules and firmware files use update-kernel script. For upgrading diskless or Data disk installations to a new release branch refer Upgrading diskless and data disk mode installs to latest release.

update-kernel script

When kernel packages with its modules and firmware packages are upgraded, the update-kernel script generates initfs images and installs them together with upgraded kernel and updates the boot files in persistent storages like customizable boot device.

  • Before upgrading, install the mkinitfs package as this is required for the generation of the initial filesystem used during boot as follows:

    # apk add mkinitfs

  • Additional initfs features that are missing in the default configuration, like the btrfs filesystem support (at the time of writing, to allow loading .apkovl configs and package cache during boot), may be enabled in the file /etc/mkinitfs/mkinitfs.conf.
  • Available initfs features may be listed with ls /etc/mkinitfs/features.d

# ls /etc/mkinitfs/features.d # apk add nano # nano /etc/mkinitfs/mkinitfs.conf # lbu commit

  • Finally update the kernel and its boot environment.

# update-kernel /media/sdXY/boot/

Note: update-kernel run needs at least 8 GB free ram memory to avoid a broken modloop-image. So, in memory constrained devices like Raspberry Pi, use the environment variable TMPDIR to point to a directory on a *nix file system formatted physical device, like a SD-Card or USB-Stick as follows:

# TMPDIR=/media/sdc1/tmp update-kernel /media/mmcblk0p1/boot/

See update-kernel --help for options to manually add additional module or firmware packages.

Documentation on kernel options

Documentation about kernel command line options regarding diskless mode can be accessed by installing the documentation sub-package mkinitfs-doc and running the command

man mkinitfs-bootparam

       If no root= parameter is given, the initramfs will build a live system
       in memory from scratch. This is also called diskless mode.

       When booting in diskless mode, the following options are also
       available:

       alpine_repo=(URL | PATH)
              If set, /etc/apk/repositories will be filled with this. May be a
              comma-separated list of URLs.

       apkovl=(URL | [DEVICE[:FS_TYPE]:]PATH)
              A HTTP, HTTPS or FTP URL to an apkovl.tar.gz file which will be
              retrieved and applied. Can also be a filesystem path, optionally
              prepended with the device name without the /dev/ prefix.

       autodetect_serial=no
              Disable automatic detection and setup of serial console.

       ds=OPTIONS
              Data source for tiny-cloud. If OPTIONS starts with nocloud,
              tiny-cloud will be enabled.

       nokeep_apk_new
              Setup a fresh system, ignore any apkovl.

       pkgs=PACKAGE{,PACKAGE}
              Comma-separated list of packages to be installed.
       ssh_key=(URL | SSH_KEY)
              This setting installs openssh and places the public key given as
              value in /root/.ssh/authorized_keys.  If the value is an HTTP or
              FTP url, its fetches the key(s) from there.

       splash Enable splash screen.

       usbdelay=NUMBER
              Wait NUMBER seconds for USB devices to show up before searching
              for boot media.

       wireguard=INTERFACE;IP_ADDRESS{,IP_ADDRESS,...}[;WG_CONFIG_FILE]
              Set up a wireguard interface named INTERFACE with the addresses
              IP_ADDRESS and use /etc/wireguard/initrd.conf or WG_CONFIG_FILE
              as a classic wg (not wg-quick) config.

       zfs_force=NUMBER
              Enable force importing the root zpool on boot, even if it was
              previously mounted from a different system/OS.

See also