Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

vmctl image

Manage VM disk images.

Synopsis

vmctl image <SUBCOMMAND>

Subcommands

vmctl image pull

Download an image to the local cache.

vmctl image pull [OPTIONS] <URL>
Argument/OptionTypeDescription
URLstringURL to download (positional)
--namestringName to save as in the cache

vmctl image list

List cached images.

vmctl image list

Output:

NAME                                     SIZE         PATH
noble-server-cloudimg-amd64.img          0.62 GB      /home/user/.local/share/vmctl/images/noble-server-cloudimg-amd64.img

vmctl image inspect

Show image format and details.

vmctl image inspect <PATH>
ArgumentDescription
PATHPath to image file (positional)

Examples

# Download and cache an image
vmctl image pull https://cloud-images.ubuntu.com/noble/current/noble-server-cloudimg-amd64.img

# List what's cached
vmctl image list

# Check format of a local image
vmctl image inspect ./my-image.qcow2