Terminal Tabs

Terminal tabs provide command-line access to containers and VMs in your lab. They’re essential for hands-on tasks that require users to run commands, edit files, or interact with services.

Creating a Terminal Tab

To create a terminal tab:

1. Navigate to the Tabs section in your lab editor
2. Click Add Tab and select Terminal from the dropdown
3. Configure the terminal settings

Supported Fields

Field	Required	Description
Name (internal)	✓	Used for internal reference. Not visible to end users
Target	✓	Container or VM to attach the terminal to
Shell		Shell program to use (default: /bin/sh)
User		User to run terminal as (default: root)
Group		Group to run terminal as (default: root)
Working Directory		Initial working directory (default: /)
Command		Command to execute instead of interactive shell

Note

Terminal tabs can target container and VM resources. They cannot directly target Kubernetes or Nomad clusters.

Running commands in this terminal

With a terminal in your layout, you can make code blocks in your instructions runnable. Users get a Run button on the block that sends the command straight to the terminal, so they don’t have to copy and paste. Add the run flag to a code block in the markdown editor to enable it. When more than one terminal is showing in the current layout, clicking Run lets the user choose which terminal to run in. A terminal in a tab that isn’t open in its panel isn’t offered.

Reference

For detailed HCL reference information, see the Terminal Reference.