LinuxCommandLibrary

toolbox-list

List available toolboxes

TLDR

List all toolbox containers and images

$ toolbox list
copy

List only toolbox containers
$ toolbox list [[-c|--containers]]
copy

List only toolbox images
$ toolbox list [[-i|--images]]
copy

SYNOPSIS

toolbox list [OPTIONS]

PARAMETERS

-i, --image
    Display the name of the container image.

-n, --name
    Display the container's name (often the default behavior).

-q, --quiet
    Suppress headers and only display container names, useful for scripting.

-s, --short
    Provide a shorter, less verbose output format.

-t, --table
    Display the output in a formatted table (this is the default output format).

-l, --latest
    Show only the most recently created container.

--no-trunc
    Do not truncate any of the output fields, showing full names and IDs.

DESCRIPTION

toolbox list is a fundamental command within the Toolbox utility, designed to manage isolated command-line environments on Linux systems, particularly useful for immutable operating systems like Fedora Silverblue.

This command provides a comprehensive overview of all existing Toolbox containers created by the user. It displays crucial information such as the container's unique name, the image it was built from, its current status (e.g., running, exited), and the time of creation.

By listing these development environments, users can quickly identify, inspect, and manage their various workspaces, making it an essential tool for developers and system administrators working with containerized workflows.

CAVEATS

The toolbox list command only displays containers created and managed by the Toolbox utility, not general podman or docker containers. It requires the Toolbox package to be installed and operational on the system.

HISTORY

The Toolbox project, including its list command, emerged primarily with the rise of immutable Linux operating systems like Fedora Silverblue and Fedora CoreOS. Its development aimed to provide a convenient and robust way for developers to create mutable, containerized environments on an otherwise read-only host filesystem. Leveraging Podman as its container engine, toolbox list has been a core command since the early days, essential for users to keep track of their various development environments and workspaces.

SEE ALSO

Copied to clipboard