Initramfs init - Revision history

Realroot: Add command when running outside system

2025-09-28T07:33:45Z

Add command when running outside system

← Older revision		Revision as of 07:33, 28 September 2025
Line 2:		Line 2:

	== Usage ==		== Usage ==
	Under a running alpine machine, the following command can be used if for some reason the initramfs has not been created properly for a new kernel.		Under a running alpine machine, the following command can be used if for some reason the initramfs has not been created properly for a new kernel.
	{{cmd\|mkinitfs -c /etc/mkinitfs/mkinitfs.conf -b / <kernelvers>}}		{{cmd\|# mkinitfs -c /etc/mkinitfs/mkinitfs.conf -b / <kernelvers>}}
	The script is located in {{path\|/sbin/}} and is created with ash. It expects {{path\|/lib/modules}} to be populated with the <code><kernelvers></code> listed. ~~For variations on this command (e.g. for chroot) Search "~~mkinitfs".		The script is located in {{path\|/sbin/}} and is created with ash. It expects {{path\|/lib/modules}} to be populated with the <code><kernelvers></code> listed.<br>
			Therefore normally just running <code>mkinitfs</code> should be enough if you need to rebuild it.

	== ~~initramfs~~ init cmdline options ==		Sometimes, e.g. to fix a non booting installation or when installing, you may have to rebuild the initramfs from another system, you do not need to chroot.<br>
			Mount <code>/</code>, <code>/boot</code> etc. and then run:
			{{cmd\|# mkinitfs -c /mnt/etc/mkinitfs/mkinitfs.conf -b /mnt/ $(ls /mnt/lib/modules/)}}

			== Initramfs init cmdline options ==

	In addition to the [https://www.kernel.org/doc/html/v4.14/admin-guide/kernel-parameters.html kernel boot parameters] are a number of parameters that the init script understands. These are documented in the <code>mkinitfs-bootparam(7)</code> man page.		In addition to the [https://www.kernel.org/doc/html/v4.14/admin-guide/kernel-parameters.html kernel boot parameters] are a number of parameters that the init script understands. These are documented in the <code>mkinitfs-bootparam(7)</code> man page.

Prabuanand: added debug_init single related to grub to troubleshoot

2024-12-16T04:15:31Z

added debug_init single related to grub to troubleshoot

← Older revision		Revision as of 04:15, 16 December 2024
Line 14:		Line 14:

	Although you may specify your own init script when building an initramfs, these parameters allow for extensive control over the initial startup of an Alpine Linux system.		Although you may specify your own init script when building an initramfs, these parameters allow for extensive control over the initial startup of an Alpine Linux system.

			== Troubleshooting ==

			To troubleshoot booting issues, when using [[Bootloaders#GRUB\|grub]], replace <code>quiet</code> with <code>debug_init single</code> in the boot command line.

	== See Also ==		== See Also ==
	* [https://wiki.postmarketos.org/wiki/The_initramfs PostmarketOS Wiki]		* [https://wiki.postmarketos.org/wiki/The_initramfs PostmarketOS Wiki]
	* [https://wiki.archlinux.org/title/Arch_boot_process#initramfs ArchWiki boot process]		* [https://wiki.archlinux.org/title/Arch_boot_process#initramfs ArchWiki boot process]

	[[category:Kernel]]		[[category:Kernel]]
	[[Category:Booting]]		[[Category:Booting]]

Prabuanand: added sample mkinitfs.conf

2024-12-16T04:09:52Z

added sample mkinitfs.conf

← Older revision		Revision as of 04:09, 16 December 2024
Line 9:		Line 9:

	In addition to the [https://www.kernel.org/doc/html/v4.14/admin-guide/kernel-parameters.html kernel boot parameters] are a number of parameters that the init script understands. These are documented in the <code>mkinitfs-bootparam(7)</code> man page.		In addition to the [https://www.kernel.org/doc/html/v4.14/admin-guide/kernel-parameters.html kernel boot parameters] are a number of parameters that the init script understands. These are documented in the <code>mkinitfs-bootparam(7)</code> man page.

			Depending on your HDD type and filesystem used, the file appears as follows:
			{{cat\|/etc/mkinitfs/mkinitfs.conf\|features{{=}}"ata base ide scsi usb virtio ext4 nvme"}}

	Although you may specify your own init script when building an initramfs, these parameters allow for extensive control over the initial startup of an Alpine Linux system.		Although you may specify your own init script when building an initramfs, these parameters allow for extensive control over the initial startup of an Alpine Linux system.

WhyNotHugo: /* initramfs init cmdline options */ remove WIP title

2024-11-12T05:48:41Z

initramfs init cmdline options: remove WIP title

← Older revision		Revision as of 05:48, 12 November 2024
Line 6:		Line 6:
	The script is located in {{path\|/sbin/}} and is created with ash. It expects {{path\|/lib/modules}} to be populated with the <code><kernelvers></code> listed. For variations on this command (e.g. for chroot) Search "mkinitfs".		The script is located in {{path\|/sbin/}} and is created with ash. It expects {{path\|/lib/modules}} to be populated with the <code><kernelvers></code> listed. For variations on this command (e.g. for chroot) Search "mkinitfs".

	== initramfs init cmdline options ~~(work in progress)~~ ==		== initramfs init cmdline options ==

	In addition to the [https://www.kernel.org/doc/html/v4.14/admin-guide/kernel-parameters.html kernel boot parameters] are a number of parameters that the init script understands. These are documented in the <code>mkinitfs-bootparam(7)</code> man page.		In addition to the [https://www.kernel.org/doc/html/v4.14/admin-guide/kernel-parameters.html kernel boot parameters] are a number of parameters that the init script understands. These are documented in the <code>mkinitfs-bootparam(7)</code> man page.

Sertonix: link to arch wiki

2023-11-10T11:28:28Z

link to arch wiki

← Older revision		Revision as of 11:28, 10 November 2023
Line 14:		Line 14:
	== See Also ==		== See Also ==
	* [https://wiki.postmarketos.org/wiki/The_initramfs PostmarketOS Wiki]		* [https://wiki.postmarketos.org/wiki/The_initramfs PostmarketOS Wiki]
			* [https://wiki.archlinux.org/title/Arch_boot_process#initramfs ArchWiki boot process]

	[[category:Kernel]]		[[category:Kernel]]
	[[Category:Booting]]		[[Category:Booting]]

Sertonix: add category booting

2023-11-10T11:27:30Z

add category booting

← Older revision		Revision as of 11:27, 10 November 2023
Line 16:		Line 16:

	[[category:Kernel]]		[[category:Kernel]]
			[[Category:Booting]]

Sertonix: link to postmarketOS Wiki

2023-09-20T18:18:15Z

link to postmarketOS Wiki

← Older revision		Revision as of 18:18, 20 September 2023
Line 11:		Line 11:

	Although you may specify your own init script when building an initramfs, these parameters allow for extensive control over the initial startup of an Alpine Linux system.		Although you may specify your own init script when building an initramfs, these parameters allow for extensive control over the initial startup of an Alpine Linux system.

			== See Also ==
			* [https://wiki.postmarketos.org/wiki/The_initramfs PostmarketOS Wiki]

	[[category:Kernel]]		[[category:Kernel]]

WhyNotHugo: Typo / formatting

2023-01-08T19:45:40Z

Typo / formatting

← Older revision		Revision as of 19:45, 8 January 2023
Line 1:		Line 1:
	~~'''~~[https://gitlab.alpinelinux.org/alpine/mkinitfs '''mkinitfs'''] is a tool to create initramfs images. Initramfs images are small images which contain a small filesystem with everything required to boot Alpine. For example, when booting a setup with [[Setting up encrypted volumes with LUKS\|full disk encryption]], the initramfs contains the binaries required to prompt for a password and mount the encrypted disk.		[https://gitlab.alpinelinux.org/alpine/mkinitfs '''mkinitfs'''] is a tool to create initramfs images. Initramfs images are small images which contain a small filesystem with everything required to boot Alpine. For example, when booting a setup with [[Setting up encrypted volumes with LUKS\|full disk encryption]], the initramfs contains the binaries required to prompt for a password and mount the encrypted disk.

	== Usage ==		== Usage ==

WhyNotHugo: Delete "draft" tag.

2023-01-08T19:44:50Z

Delete "draft" tag.

← Older revision		Revision as of 19:44, 8 January 2023
Line 1:		Line 1:
	~~{{draft}}~~		'''[https://gitlab.alpinelinux.org/alpine/mkinitfs '''mkinitfs'''] is a tool to create initramfs images. Initramfs images are small images which contain a small filesystem with everything required to boot Alpine. For example, when booting a setup with [[Setting up encrypted volumes with LUKS\|full disk encryption]], the initramfs contains the binaries required to prompt for a password and mount the encrypted disk.

	[https://gitlab.alpinelinux.org/alpine/mkinitfs '''mkinitfs'''] is a tool to create initramfs images. Initramfs images are small images which contain a small filesystem with everything required to boot Alpine. For example, when booting a setup with [[Setting up encrypted volumes with LUKS\|full disk encryption]], the initramfs contains the binaries required to prompt for a password and mount the encrypted disk.

	== Usage ==		== Usage ==

WhyNotHugo:


2023-01-08T19:44:24Z
<code>

				
				
				
				
				
				← Older revision
				Revision as of 19:44, 8 January 2023
				
Line 6:
Line 6:
Under a running alpine machine, the following command can be used if for some reason the initramfs has not been created properly for a new kernel.   Under a running alpine machine, the following command can be used if for some reason the initramfs has not been created properly for a new kernel.  
  {{cmd|mkinitfs -c /etc/mkinitfs/mkinitfs.conf -b / <kernelvers>}}   {{cmd|mkinitfs -c /etc/mkinitfs/mkinitfs.conf -b / <kernelvers>}}
The script is located in {{path|/sbin/}} and is created with ash. It expects {{path|/lib/modules}} to be populated with the <kernelvers> listed. For variations on this command (e.g. for chroot) Search "mkinitfs". The script is located in {{path|/sbin/}} and is created with ash. It expects {{path|/lib/modules}} to be populated with the <code><kernelvers></code> listed. For variations on this command (e.g. for chroot) Search "mkinitfs".



== initramfs init cmdline options (work in progress) == == initramfs init cmdline options (work in progress) ==