Skip to content

System Commands

Commands for managing system components

Manage an image builder instance

Usage:

Terminal window
container builder <subcommand>

Start builder

Usage:

Terminal window
builder start [command options]

Options:

  • -c, --cpus <cpus> - Number of CPUs to allocate to the container (default: 2)
  • -m, --memory <memory> - Amount of memory in bytes, kilobytes (K), megabytes (M), or gigabytes (G) for the container, with MB granularity (for example, 1024K will result in 1MB being allocated for the container) (default: 2048MB)

Print builder status

Usage:

Terminal window
builder status [command options]

Options:

  • --json - Display detailed status in json format

Stop builder

Usage:

Terminal window
builder stop

Delete builder

Usage:

Terminal window
builder delete [command options]

Options:

  • -f, --force - Force delete builder even if it is running

Aliases: s

Manage system components

Usage:

Terminal window
container system <subcommand>

Manage local DNS domains

Usage:

Terminal window
container system dns <subcommand>

Create a local DNS domain for containers (must run as an administrator)

Usage:

Terminal window
container system dns create <domain-name>

Aliases: rm

Delete a local DNS domain (must run as an administrator)

Usage:

Terminal window
container system dns delete <domain-name>

Aliases: ls

List local DNS domains

Usage:

Terminal window
container system dns list

Set or unset the default local DNS domain

Usage:

Terminal window
container system dns default <subcommand>

Fetch system logs for container services

Usage:

Terminal window
container system logs [--debug] [--last <last>] [--follow]

Options:

  • --last <last> - Fetch logs starting from the specified time period (minus the current time); supported formats: m, h, d (default: 5m)
  • -f, --follow - Follow log output

Start container services

Usage:

Terminal window
container system start [--path <path>] [--debug] [--enable-kernel-install] [--disable-kernel-install]

Options:

  • -p, --path <path> - Path to the container-apiserver binary (default: /usr/local/bin/container)
  • --debug - Enable debug logging for the runtime daemon
  • --enable-kernel-install/--disable-kernel-install - Specify whether the default kernel should be installed or not. The default behavior is to prompt the user for a response

Stop all container services

Usage:

Terminal window
container system stop [--prefix <prefix>]

Options:

  • -p, --prefix <prefix> - Launchd prefix for container services (default: com.apple.container.)

Show the status of container services

Usage:

Terminal window
container system status [--prefix <prefix>]

Options:

  • -p, --prefix <prefix> - Launchd prefix for container services (default: com.apple.container.)

Manage the default kernel configuration

Usage:

Terminal window
container system kernel <subcommand>