Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/apple/container/llms.txt

Use this file to discover all available pages before exploring further.

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

​
--arch
string
default:"arm64"
The architecture of the kernel binary (values: amd64, arm64)
​
--binary
string
Path to the kernel file (or archive member, if used with —tar)
​
--force
boolean
Overwrites an existing kernel with the same name
​
--recommended
boolean
Download and install the recommended kernel as the default (takes precedence over all other flags)
​
--tar
string
Filesystem path or remote URL to a tar archive containing a kernel file
​
--debug
boolean
Enable debug output

​
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.

Build docs developers (and LLMs) love

Get started for freeTalk to us