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.

Instruqt Lab Documentation

Integration with an External VCS

Overview

Section titled “Overview”

Every lab uses Instruqt’s native version control from the moment you create it. No setup is required: each time you Publish a lab, the commit shows up in Change History.

You can also connect a lab to a repository on GitHub, so publishing keeps that repository in sync alongside the native history. Disconnecting stops the syncing but keeps everything you already have, both in Instruqt and in the repository.

Connecting a lab

Section titled “Connecting a lab”

Open the lab and click Project settings in the top bar, then select Version control in the settings sidebar.

If the lab isn’t connected yet, the page shows a Connect repository button. The same button appears as a Connect your repository card in the Recent changes section of the lab’s Overview page while no repository is connected.

Clicking Connect repository opens the Connect repository dialog:

  1. Pick the GitHub account to use from the Git account dropdown. If no account is listed, click Configure GitHub App to install or grant the Instruqt GitHub App access to your organization. This opens GitHub in a new tab, and the dialog refreshes automatically once you switch back.
  2. Search for the repository you want, or scroll the list. Private repositories show a lock icon next to their name.
  3. Click Connect next to the repository you want to use.

A success notification confirms the connection. The Version control page then shows the connection’s details: Account, Repository (a link to the repository on GitHub), Default branch, and Directory.

Disconnecting a lab

Section titled “Disconnecting a lab”

On the Version control settings page, click Disconnect. A confirmation dialog titled “Disconnect from your version control system” explains what happens: the lab stops syncing with the connected repository, a copy of the content remains in your VCS, and the lab’s versions, change history, and other version control abilities stay available through the native Instruqt version control. Confirm by clicking Disconnect again.

Only a lab connected at its repository’s root directory (/) can be disconnected. If it was connected at a sub-directory, the Disconnect button is disabled because the connection is shared with other labs rooted in that same repository. See Limitations for details.

Learn more

Section titled “Learn more”
  • Editing & Publishing covers how edit mode, Add changes, and Publish work, whether or not a lab is connected to an external repository.
  • Version Control overview covers what version control means across the platform and its current limitations.