Skip to main content
The system property commands allow you to list, get, set, and clear system configuration properties.

List properties

Lists all available system properties with their current values, types, and descriptions. Output can be formatted as a table or JSON.

Usage

container system property list [--format <format>] [--quiet] [--debug]

Options

--format
string
default:"table"
Format of the output (values: json, table)
-q, --quiet
boolean
Only output the property ID

Examples

# list all properties in table format
container system property list

# get only property IDs
container system property list --quiet

# output as JSON for scripting
container system property list --format json

Get property

Retrieves the current value of a specific system property by its ID.

Usage

container system property get [--debug] <id>

Arguments

id
string
required
The property ID

Examples

# get the default registry domain
container system property get registry.domain

# get the current DNS domain setting
container system property get dns.domain

Set property

Sets the value of a system property. The command validates the value based on the property type (boolean, domain name, image reference, URL, or CIDR address).

Usage

container system property set [--debug] <id> <value>

Arguments

id
string
required
The property ID
value
string
required
The property value

Examples

# enable Rosetta for AMD64 builds on ARM64
container system property set build.rosetta true

# set a custom DNS domain
container system property set dns.domain mycompany.local

# configure a custom registry
container system property set registry.domain registry.example.com

# set a custom builder image
container system property set image.builder myregistry.com/custom-builder:latest

Clear property

Clears (unsets) a system property, reverting it to its default value.

Usage

container system property clear [--debug] <id>

Arguments

id
string
required
The property ID

Examples

# clear custom DNS domain (revert to default)
container system property clear dns.domain

# clear custom registry setting
container system property clear registry.domain

Build docs developers (and LLMs) love