Images

shard pull

Download an image.

shard pull IMAGE

Example

shard pull python:3.12

Arguments

Argument	Description
IMAGE	image reference, such as python:3.12

Prints the image reference and digest when the download finishes.

Runs only on the daemon host and refuses --remote, SHARD_REMOTE and a saved connection.

shard image

Manage downloaded images.

shard image COMMAND [OPTIONS] [ARGS...]

Commands

Command	Description
shard image list	list downloaded images
shard image remove	delete a downloaded image
shard image prune	delete unused images

shard image list

List downloaded images.

shard image list [OPTIONS]

Examples

shard image list
shard image list --format json

Options

Option	Description	Default
--format <format>	output format: json or table	table

Runs only on the daemon host and refuses --remote, SHARD_REMOTE and a saved connection.

shard image remove

Delete a downloaded image.

shard image remove [OPTIONS] IMAGE

Example

shard image remove python:3.12

Arguments

Argument	Description
IMAGE	image reference

Options

Option	Description
--force	delete the image even if a sandbox or snapshot uses it

Runs only on the daemon host and refuses --remote, SHARD_REMOTE and a saved connection.

shard image prune

Delete images that no sandbox or snapshot uses.

shard image prune

Example

shard image prune

Images used by stopped sandboxes are also kept.

Runs only on the daemon host and refuses --remote, SHARD_REMOTE and a saved connection.