alpine-bootparams − control the startup behavior using the kernel command line
In early boot, the preferred way to supply configuration data to the running system is via kernel options. The kernel options are specified in the bootloader configuration and are supplied to the kernel and early userspace in early boot. The mechanism and options that are interpreted by the kernel itself are documented in bootparam(7).
The options
documented here are interpreted by the initramfs-init script
that is part of the initramfs, see mkinitfs(1) to
learn how to customize it.
blacklist=MODULE{,MODULE}
This comma-separated list names kernel modules that modprobe will reject to load.
chart |
Enables bootchartd for measuring system startup speed. |
cryptdiscards
Enable the discard feature for encrypted Solid State Disks. This might have security implications.
cryptdm=NAME
After the block device has been decrypted, make it available as /dev/mapper/NAME.
cryptheader=DEVICE
When the LUKS headers and encrypted data are on different devices, this option specifies the device with the LUKS headers.
cryptkey=KEYFILE
Attempt to decrypt an encypted partition using an keyfile.
cryptoffset=SECTORS
Indicate that the encrypted data begins the given number of sectors after the start of the block device.
cryptroot=DEVICE
Attempt to decrypt DEVICE.
dasd |
Enable DASD devices on S/390x architectures. |
|||
zfcp |
Enable zFCP SCSI devices on S/390x architectures. |
debug_init
Print debug information during boot.
init=PATH
Path to init program to execute instead of /sbin/init.
init_args=ARGUMENTS
Additional command line arguments for /sbin/init.
ip=CLIENT-IP:SERVER-IP:GATEWAY-IP:NETMASK:HOSTNAME:DEVICE:AUTOCONF:DNS-IP:DNS-IP:NTP-IP
Specify the network configuration. The format is equivalent to the linux kernel option with the same name. Per default, the SERVER-IP, HOSTNAME and NTP-IP parameters are ignored by the initramfs. Consult the kernel documentation on nfsroot for further information regarding the fields of this parameter.
modules=MODULE{,MODULE}
Comma-sparated list of kernel modules to load explicitly.
nbd=HOST:PORT{,...}
Comma-separated list of nbd servers. Connects to each server running nbd-server to use its exported block device.
overlaytmpfs
When booting from a read-only filesystem, you can specify this flag to have your changes written to an in-memory temporary overlayfs. The underlying filesystem will always be mounted read-only, the overlay always writable.
overlaytmpfsflags=OPTIONS
Optional comma-separated list of tmpfs(5) mount options when overlaytmpfs is used. The default is mode=0755,rw, you cannot override rw.
quiet |
Generate less output. |
resume=DEVICE
Swap partition to resume from.
root=(DEVICE | nfs:IP-ADDRESS:PATH)
Device or NFS url for the root partition.
rootflags=OPTIONS
Mount options for the device specified with root=.
rootfstype=FS_TYPE
File system type for the device specified with root=. Allowed values are the same like the −t option for mount(1).
s390x_net=qeth_l2,BUS-ID{,BUS-ID}
Configure network devices for the S/390x architecture.
single |
Launch root shell before switching to the root partition. |
uevent_buf_size=BYTES
Set the buffer size for kernel uevents.
If no root= parameter is given, the initramfs will build an 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 an URL.
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.
zfs_force=NUMBER
Enable force importing the root zpool on boot, even if it was previously mounted from a different system/OS.
/usr/share/mkinitfs/initramfs-init
Default script that will be run in the initramfs.
Written by Natanael Copa <[email protected]>, Timo Teräs <[email protected]> and others.
Alpine Linux GitLab: <https://gitlab.alpinelinux.org/alpine/mkinitfs/-/issues>
nlplug-findfs(1), mkinitfs(1), bootparam(7)