Start a Toolbx container

You can start a Toolbx container to enter an isolated environment for development or troubleshooting. Entering the container ensures you can install and run command-line tools without modifying the underlying host operating system.

Procedure

  1. Create a Toolbx container:
    • As a rootless user:
      $ toolbox create <mytoolbox>
      Created container: <mytoolbox>
      Enter with: toolbox enter <mytoolbox>
    • As a root user:
      $ sudo toolbox create <mytoolbox>
      Created container: <mytoolbox>
      Enter with: toolbox enter <mytoolbox>
    • Verify that you pulled the correct image:
      [user@toolbox ~]$ toolbox list
      IMAGE ID      IMAGE NAME    CREATED
      fe0ae375f149   registry.access.redhat.com/ubi10/toolbox:latest 5 weeks ago
      
      CONTAINER ID  CONTAINER NAME  CREATED         STATUS   IMAGE NAME
      5245b924c2cb  <mytoolbox>       7 minutes ago   created  registry.access.redhat.com/ubi10/toolbox:latest
  2. Enter the Toolbx container:
    [user@toolbox ~]$ toolbox enter <mytoolbox>

Results

  • Enter a command inside the <mytoolbox> container and display the name of the container and the image:
    [user@toolbox ~]$ cat /run/.containerenv
    engine="podman-4.8.2"
    name="<mytoolbox>"
    id="5245b924c2cb..."
    image="registry.access.redhat.com/ubi10/toolbox:latest"
    imageid="fe0ae375f14919cbc0596142e3aff22a70973a36e5a165c75a86ea7ec5d8d65c"