How to use the command `toolbox list` (with examples)

The toolbox list command is used to list existing toolbox containers and images. This command is helpful when you want to view the containers and images that are available in your toolbox.

Use case 1: List all toolbox containers and images

Code:

toolbox list

Motivation: When you want to view all the toolbox containers and images that are present on your system, you can use the toolbox list command. This allows you to have a quick overview of the available containers and images and their names.

Explanation: The toolbox list command without any arguments lists all the toolbox containers and images.

Example output:

CONTAINER ID         IMAGE                          COMMAND             CREATED             STATUS             PORTS

Use case 2: List only toolbox containers

Code:

toolbox list --containers

Motivation: Sometimes you might only be interested in viewing the toolbox containers and not the images. In such cases, you can use the toolbox list --containers command to only list the existing containers.

Explanation: The --containers argument filters the output to show only the existing toolbox containers.

Example output:

CONTAINER ID         IMAGE                          COMMAND             CREATED             STATUS             PORTS
7af4b076f575        fedora-toolbox:latest          /bin/bash           2 days ago          Up 2 days 
e45bb6208f99        ubuntu-toolbox:latest          /bin/bash           2 days ago          Up 2 days 

Use case 3: List only toolbox images

Code:

toolbox list --images

Motivation: At times, you might want to see only the toolbox images that are available on your system. This can be useful when you want to check if a specific image is present or to get an overview of the available images.

Explanation: The --images argument filters the output to show only the toolbox images.

Example output:

IMAGE                         TAG            CREATED           SIZE
fedora-toolbox                latest         2 days ago        200MB
ubuntu-toolbox                latest         2 days ago        220MB

Conclusion:

The toolbox list command is a handy tool to list toolbox containers and images. Whether you want to see all the containers and images, only the containers, or only the images, this command provides you with the necessary information.