LinuxCommandLibrary

boot

Boot the system

TLDR

Start a REPL session either with the project or standalone

$ boot repl
copy

Build a single uberjar
$ boot jar
copy

Generate scaffolding for a new project based on a template
$ boot --dependencies boot/new new --template [template_name] --name [project_name]
copy

Build for development (if using the boot/new template)
$ boot dev
copy

Build for production (if using the boot/new template)
$ boot prod
copy

Display help for a specific task
$ boot [task] --help
copy

SYNOPSIS

boot

DESCRIPTION

The boot command is fundamental to the GRUB bootloader in Linux systems. It finalizes the boot configuration by loading the specified kernel and initramfs into memory, then relinquishing control to the kernel to start the operating system. Typically used after commands like linux to load the kernel image (e.g., vmlinuz) with root device and parameters, and initrd for the initial ramdisk. When executed at the GRUB prompt ("grub>") or via menu selection, GRUB passes the command line arguments to the kernel, which mounts filesystems and invokes the init process (e.g., systemd). This enables booting into multi-user mode or rescue environments. In interactive mode, users can troubleshoot boot issues by manually configuring and running boot. Unlike shell commands, it operates in real mode or protected mode pre-OS. Documentation is in info grub or GRUB manual. Not executable from Linux shell; requires bootloader context. Supports chainloading other bootloaders too.

CAVEATS

Only works in GRUB bootloader shell, not Linux user shell ("command not found" error). Requires prior linux/initrd setup; fails otherwise.

BASIC EXAMPLE

grub> linux /boot/vmlinuz-6.1.0 root=/dev/sda1
grub> initrd /boot/initrd.img-6.1.0
grub> boot

RESCUE USAGE

If kernel panic drops to GRUB: set root=(hd0,1); linux /vmlinuz root=/dev/sda1 single; boot

HISTORY

Originated in GRUB 0.5 (1996) by Erich Boleyn; evolved in GRUB Legacy (0.90-0.97, 2001-2005); ported to GRUB 2 (2009+) with modular design for UEFI/BIOS support.

SEE ALSO

Copied to clipboard