Skip to content

You are viewing documentation for Instruqt 2.0 Labs which is in Beta currently. Official release date - 29 September, 2026. For Tracks documentation, please visit docs.instruqt.com.

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.

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
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

With a terminal in your layout, you can make code blocks in your instructions runnable. Learners 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 a layout has more than one terminal, clicking Run lets the learner choose which terminal to run in.

For detailed HCL reference information, see the Terminal Reference.