Installs or updates the Linux kernel used by the container runtime on macOS hosts.
Usage
container system kernel set [--arch <arch>] [--binary <binary>] [--force] [--recommended] [--tar <tar>] [--debug]
Options
The architecture of the kernel binary (values: amd64, arm64)
Path to the kernel file (or archive member, if used with —tar)
Overwrites an existing kernel with the same name
Download and install the recommended kernel as the default (takes precedence over all other flags)
Filesystem path or remote URL to a tar archive containing a kernel file
Examples
# Install the recommended kernel
container system kernel set --recommended
# Install a kernel from a local file
container system kernel set --binary /path/to/vmlinuz
# Install a kernel from a tar archive
container system kernel set --tar /path/to/kernel.tar.xz --binary vmlinuz
# Force overwrite existing kernel
container system kernel set --binary /path/to/vmlinuz --force
The recommended kernel is automatically selected based on your system’s architecture.
Changing the kernel requires stopping all containers and restarting the container service.