CLI

lawn system

System-level commands for CLI setup, network checks, registry mirrors, and experiments.
CommandDescription
lawn system images listList stored images and their retention status
lawn system images pruneRemove unused images
lawn system cli installCreate a symlink in /usr/local/bin
lawn system cli uninstallRemove the symlink
lawn system network-checkCheck local network permission
lawn system config update-snapshots [value]Read or change update Snapshot retention
lawn system config mirror listList registry mirrors
lawn system config mirror set <registry> <mirror-url>Set a mirror
lawn system config mirror remove <registry>Remove a mirror
lawn system config experiments listList experimental features
lawn system config experiments enable <id>Enable an experiment
lawn system config experiments disable <id>Disable an experiment

lawn system images list

List stored container images and whether they are still needed.

lawn system images list

lawn system images prune

Remove images and unpacked image versions that no installed app, retained snapshot, or operation needs. Lawn also cleans up unused images automatically.

OptionDescription
--dry-runShow what is currently eligible without deleting it.
lawn system images prune --dry-run
lawn system images prune

lawn system cli install

Create a symlink to the lawn binary in /usr/local/bin, making it available system-wide.

lawn system cli install

lawn system cli uninstall

Remove the lawn symlink from /usr/local/bin.

lawn system cli uninstall

lawn system network-check

Check whether Lawn has local network permission. This permission is required for other devices on your network to access apps running on your Mac.

lawn system network-check

lawn system config update-snapshots

Read or change update Snapshot retention. Values are delete-after-update, 30-days (the default), and keep.

# Show the current setting
lawn system config update-snapshots

# Keep update Snapshots for 30 days
lawn system config update-snapshots 30-days

lawn system config mirror list

List all configured registry mirrors.

lawn system config mirror list

Aliases: ls

lawn system config mirror set

Set a mirror URL for a registry domain.

lawn system config mirror set <registry> <mirror-url>
# Mirror Docker Hub through a local cache
lawn system config mirror set docker.io https://mirror.local:5000

lawn system config mirror remove

Remove a configured mirror.

lawn system config mirror remove <registry>

Aliases: rm

lawn system config mirror remove docker.io

lawn system config experiments list

List all available experimental features and whether they are enabled or disabled.

lawn system config experiments list

Aliases: ls

lawn system config experiments enable

Enable an experimental feature.

lawn system config experiments enable <experiment-id>

Use lawn system config experiments list to see available experiments.

lawn system config experiments disable

Disable an experimental feature.

lawn system config experiments disable <experiment-id>