Skip to content

You are viewing documentation for Instruqt 2.0 Labs. For Tracks documentation, please visit docs.instruqt.com.

What's New in Instruqt 2.0


Instruqt 2.0 is not a coat of paint on the platform you already know. The content model, the authoring experience, and the way sandboxes are defined have all been rebuilt. There are 56 new or reworked capabilities, a set of new names for familiar concepts, ten features that now work differently, and a small number that have been removed.

Almost every other change on this page depends on this vocabulary, so it is worth two minutes.

You used to sayIn 2.0 it isWhat is different
TrackLabThe core unit of content
ChallengePage, grouped into chaptersA page holds instructions, tasks, and quizzes together
CheckTaskMultiple conditions per task, each with its own fail message
Sandbox presetModuleReusable across labs and versioned through a registry. Modules arrive at general availability, not in Early Access
Custom resourceTerraformStandard Terraform replaces the custom abstraction
Track level scriptExec resourceDeclared as a resource, not a separate script file
Challenge scriptTask or condition scriptTied to the individual condition it validates

Sandboxes are declared, not scripted. The base language moves from YAML to HCL. Resources are declared directly and reference each other, so the environment is explicit, reviewable, and far less dependent on setup scripts.

Pages replaced challenges. A page can carry instructions, several tasks, and quizzes at once, in any order. Chapters group pages into themes, so a lab has visible structure instead of one long sequence.

Version control is built in. Every lab is versioned from the moment it is created. No integration to configure, no separate tooling. Branches, version tags, and an optional connection to your own GitHub repository sit on top of that.

Reuse is a first class concept. Modules package any combination of sandbox resources, instructions, and tabs into one versioned unit, published to a registry your whole team pulls from. Modules are not part of Early Access. They arrive at general availability.

AI is part of authoring. The AI Lab Builder is available now at general availability. It plans and drafts a lab from a description of the outcome you want, backed by a knowledge base that researches your company, products, and users first.

The sandbox is now a set of typed resources you declare and reference, rather than configuration plus scripts.

FeatureWhat it doesAvailable
Declarative sandboxesHCL replaces YAML. Resources are declared directly and reference each other, so the whole environment reads as one definition.Early Access
ContainersCPU, memory, and GPU limits, plus health checks that can test HTTP, TCP, or run a command.Early Access
NetworkAn isolated network that containers and other resources share, for communication between them or to segment parts of a lab.Early Access
ExecRuns a command on a remote system as part of setup, replacing what used to live in a track level script.Early Access
TerraformRuns Terraform as part of setup through a Terraform registry, replacing custom resources.Early Access
Kubernetes clusterProvisions a cluster as its own resource, so it can be referenced and ordered correctly against what depends on it.Early Access
Kubernetes configRepresents a kubeconfig as its own resource, so cluster access can be declared and referenced like anything else.Early Access
TemplateGenerates a configuration file or script from a template, instead of hardcoding values into a lab.Early Access
Random generatorsBuilt in generators for creature names, IDs, numbers, passwords, and UUIDs.Early Access
Dynamic valuesFour building blocks for moving values through a lab, including secrets for team managed values and variables for values a lab declares itself.Early Access
Expression and literal fieldsA toggle on any field, whether an ordinary resource setting or the value of a variable, so you can enter a fixed value or compute one.Early Access
Native assets and filesAssets and files are part of a lab’s structure, whether you work in the UI or in code.Early Access
Virtual browserA new browser engine with meaningfully better performance, more reliable behavior, and working copy and paste.GA
SidecarAn additional container that runs alongside a main container for a specialized function, sharing its context.Post GA
IngressRoutes external traffic to a service over HTTP or HTTPS, giving it a real URL instead of a raw IP.Post GA
CopyCopies files or synchronizes a directory between host and container, instead of scripting the transfer.Post GA
HelmDeploys a Helm chart into a cluster as its own resource, ordered correctly against the cluster itself.Post GA
HTTPMakes an API call as part of setup, to seed data or confirm a service is ready before users arrive.Post GA
Nomad cluster and jobDeploys a Nomad cluster and schedules a job on it, the Nomad equivalent of the Kubernetes resources.Post GA
CertificatesCertificate CA and Certificate Leaf resources generate a full certificate chain declaratively.Post GA
PausingPausing a running lab, so a user can stop and pick it up later.Post GA

Hotstarts are not available in Early Access. If your labs rely on hotstarts today, factor that into when you plan to move them across.

Two features aimed squarely at the time between “it broke” and “I know why.”

FeatureWhat it doesAvailable
ValidationThe instruqt lab validate command checks a lab’s definition, its resource references, and its task mappings before the lab ever runs.Early Access
LogsA rebuilt logs experience with more information, real controls to filter and slice it, and a layout built for finding a cause quickly.Early Access

How a lab is assembled, and what a user sees on screen at each step.

FeatureWhat it doesAvailable
PagesChallenges are now pages. A single page can combine instructions, multiple validations, and quizzes.Early Access
ChaptersFolders for pages, grouped by theme, so you can label the journey itself and not just its steps.Early Access
LayoutsSet per page, so the screen changes as a user moves through a lab: one tab for a reading step, a terminal and an editor for a hands on one.Early Access
Persistent tabsA tab is created once and assigned to a layout, carrying the user’s actual state forward across every page it appears on.Early Access
Notes tabNotes are a tab type, so they can be placed anywhere in a layout, as many as you need, only where they help.Early Access
Cloud credentials tabNatively exposes the credentials for a given cloud account, so a user sees what they need without you writing it out.Early Access
Labs without instructionsA lab does not need instructions at all, which turns it into an open ended environment rather than a guided one.Early Access
Sandboxless labsA lab type with no sandbox attached, just instructional content, quizzes, and presentation material.Post GA

The pieces you drop onto a page. Tasks and quizzes together are called activities, and you can place as many of them on a page as the content needs.

FeatureWhat it doesAvailable
ActivitiesThe group name for tasks and quizzes, covering everything you ask a user to do or answer. Both sit inline on a page, in any order, and can be mixed on the same page.Early Access
TasksTasks replace checks as a real component on a page rather than a button. A task holds multiple conditions, each with its own fail message.Early Access
QuizzesInline on any page, multiple questions on one screen, with new types including text input and number input.Early Access
Completion componentPlaced at the end of a lab with a customizable message, buttons, and links, so you control where a user goes next.Early Access
Feedback componentFeedback sits directly in the content, on a page or in a notes tab, with customizable question text. A lab can include several.GA
Embedded PDFsA PDF is embedded directly into a lab and renders inline.Early Access
Embedded Google SlidesA Google Slides URL renders inline, the same way a PDF does.Early Access

Version control is not only an integration you switch on. It is how labs work.

FeatureWhat it doesAvailable
Built in version controlEvery lab is versioned from creation, with no GitHub setup and no separate tools. Every change is captured with who made it and when.Early Access
BranchesAny lab can have multiple branches, each a complete working version that can be played and shared on its own.Early Access
Version tagsMark a known good version of a lab, so content that drifts out of date can be pinned, compared, and rolled back.Early Access
GitHub integrationConnect a lab to your own repository, monorepos included, so lab content lives alongside the rest of your code and syncs both ways.Early Access
Edit modeSeparates viewing a lab from actively editing it, so it is always clear whether you are looking or changing.Early Access

Built for teams maintaining many labs rather than a handful. Modules and the module registry are not available in Early Access. Both arrive at general availability.

FeatureWhat it doesAvailable
ModulesA reusable package built from any collection of elements: sandbox resources, instructions, tabs, and more, versioned as a unit.GA
Module registryA central space where every module for your team lives, versioned and tracked as it changes.GA
Lab templatesSave an existing lab as a template and use it as a scaffold for future labs, built to be copied safely.Early Access

The day to day of building, and the part most people notice first.

FeatureWhat it doesAvailable
New creator UIExposes what used to be hidden or implicit, with a genuinely better authoring experience built on top of it.Early Access
Markdown editorShows content close to how a user will actually see it, instead of the raw markdown behind it.Early Access
Command centerA search bar, or cmd+k, that finds anything in a lab and jumps you straight to it.Early Access
Resource usage visibilityA label on any resource shows everywhere else it is used in the lab, and clicking through takes you there.Early Access
Inline comments and notesTeam documentation attached to a resource, explaining why it exists or what it is for.Early Access
Assets and files in the UIA dedicated tab shows a lab’s full structure: assets, files, and scripts together.Early Access
In product documentationTooltips surface the relevant documentation where you are working, with a link through to the full page.Early Access
Dark and light modeChoose the theme that suits how and when you work.Early Access
FeatureWhat it doesAvailable
AI Lab BuilderDescribe what a lab should achieve and who it is for. It plans the structure, then builds it with you inside the product.GA
Knowledge baseResearch that happens before anything gets built, covering your company, your products, your users, and the context around them.GA

These capabilities still exist, but the way you use them has changed.

PreviouslyNowWhat this means for you
ScriptsExec resources and declarative sandboxesSetup splits into two parts: exec resources for genuinely imperative steps, and declarative definitions for the environment. The environment becomes reviewable like infrastructure code, and there is less scripting overall, so setup is less fragile.
ChallengesPages and chaptersA page is more flexible than a challenge. Tasks can go anywhere on a page, several can sit together, and quizzes belong on pages too. Chapters group pages so topics are visibly separated.
QuizzesInline quizzesNo dedicated page required. Place a quiz where it is relevant, put several on one page, and use the new question types for more nuanced assessment. Quizzes and tasks are now both activities.
Feedback in labsFeedback componentFeedback is no longer a fixed part of a lab. It is a component you place, as many times as you like, with question text you write. Because the request sits in the content, more users answer it.
Happiness scoreAverage of all feedback componentsThe score is the average of every rating from every feedback component in a lab rather than one fixed rating at the end. Each rating records the page it was given on, so you can see which page moves satisfaction, and you collect signal from users who never reach the end. See the Lab feedback report.
Final pageCompletion componentThe end of a lab is a component like any other, with a message, button label, and link you control, so you can connect a finished lab to whatever comes next.
Sandbox presetsModulesA module packages a sandbox the way a preset did, and then goes further: it can bundle instructions, tabs, and other parts of a lab into one reusable, versioned unit shared across many labs. Modules are not available in Early Access, they arrive at general availability.
Custom resourcesTerraformCustom resources were always Terraform underneath. Now Terraform is exposed directly, so existing Terraform knowledge applies instead of a proprietary abstraction doing the same job.
CLIGit, with GitHub integrationGitHub integration syncs changes directly, so pushing and pulling happen through a normal git workflow. Every change is recorded, conflicts resolve through a pull request instead of one side losing work, and you can author in your own editor. The CLI still scaffolds a new lab from a template.
Track IDComputed id, resource.lab.{slug}The identifier is derived from the resource type and name instead of being a random string, so it is predictable, readable, and tied to the slug.

These have been removed with no direct equivalent. Some could return based on customer demand.

FeatureWhere it stands
Loading between challengesPages and resources all load at the start of a lab, so there is nothing to load between pages.
Notes as a loading pageBecause loading happens up front, there is no notes page to read while you wait.
Loading customizationNotes only, full access, and default or custom loading messages are not carried forward.
Lab teaserNo equivalent in 2.0. It could return if customers ask for it.
Challenge descriptionNo equivalent. Page and chapter structure covers how content is organized instead.
Hotstart for sandbox presetsSandbox presets are gone, so this goes with them. Hotstarts for modules may follow later, depending on demand.

Early Access means available now, in the Early Access release.

GA means it is not in Early Access and arrives at general availability.

Post GA means it is planned for after general availability.