Set up Instruqt
What you need to start.
You need the following to start building tracks in Instruqt:
  • An Instruqt account
  • A building tool

Step 1: Get your Instruqt account

You can get a free test drive if you do not have an Instruqt account already.

Step 2: Choose your building tool

You can build tracks with the following tools:
  • Web UI A web app that runs in all major browsers.
  • Instruqt CLI A CLI on your Mac, Linux, or Windows machine.
You are free to choose your building tool. And can even use both tools side by side. Trainers and marketers lean towards the Web UI; developers and sales engineers towards the Instruqt CLI.

Step 3: Set up your chosen tool

Either start the Web UI or install the Instruqt CLI:
🌐 Web UI
πŸ’» Instruqt CLI
  1. 1.
    Open your browser and go to play.instruqt.com​
  2. 2.
    Click Login in the upper right of the Study Room page.
  3. 3.
    Enter your Email and Password in the Login window and click Login. ↳ You are logged in now, and the Creator Studio page opens.
The Instruqt CLI is available for Mac, Linux, and Windows. The corresponding installation files are available on GitHub. Pick the installation route for your machine:
Mac
🐧 Linux
Windows
  1. 1.
    Open a terminal.
  2. 2.
    Copy and paste the following code:
    1
    curl -L https://github.com/instruqt/cli/releases/download/2036-df08c03/instruqt-darwin-2036-df08c03.zip -o instruqt.zip
    2
    unzip instruqt.zip
    3
    sudo cp instruqt /usr/local/bin
    4
    sudo chmod +x /usr/local/bin/instruqt
    Copied!
  3. 3.
    Enter the following command to check if Instruqt CLI was installed correctly:
    1
    instruqt
    Copied!
    ↳ You installed the Instruqt CLI correctly if you get the following output:
    1
    The instruqt SDK command line client is used to create and manage tracks.
    2
    ​
    3
    Usage:
    4
    instruqt [command]
    5
    ​
    6
    Available Commands:
    7
    active-users List all users playing an invite
    8
    auth Authentication commands.
    9
    challenge Create and manage challenges.
    10
    completion Generate shell auto completion scripts.
    11
    config View and edit Instruqt CLI configuration.
    12
    developer Manage the developers of a track.
    13
    help Help about any command
    14
    note Create and manage notes.
    15
    track Create and manage tracks
    16
    update Update the CLI.
    17
    version Show the version of the CLI.
    18
    ​
    19
    Flags:
    20
    -h, --help help for instruqt
    21
    ​
    22
    Use "instruqt [command] --help" for more information about a command.
    Copied!
  1. 1.
    Open a terminal.
  2. 2.
    Copy and paste the following code:
    1
    curl -L https://github.com/instruqt/cli/releases/download/2036-df08c03/instruqt-linux-2036-df08c03.zip -o instruqt.zip
    2
    unzip instruqt.zip
    3
    sudo cp instruqt /usr/local/bin
    4
    sudo chmod +x /usr/local/bin/instruqt
    Copied!
  3. 3.
    Enter the following command to check if Instruqt CLI was installed correctly:
    1
    instruqt
    Copied!
    ↳ You installed the Instruqt CLI correctly if you get the following output:
    1
    The instruqt SDK command line client is used to create and manage tracks.
    2
    ​
    3
    Usage:
    4
    instruqt [command]
    5
    ​
    6
    Available Commands:
    7
    active-users List all users playing an invite
    8
    auth Authentication commands.
    9
    challenge Create and manage challenges.
    10
    completion Generate shell auto completion scripts.
    11
    config View and edit Instruqt CLI configuration.
    12
    developer Manage the developers of a track.
    13
    help Help about any command
    14
    note Create and manage notes.
    15
    track Create and manage tracks
    16
    update Update the CLI.
    17
    version Show the version of the CLI.
    18
    ​
    19
    Flags:
    20
    -h, --help help for instruqt
    21
    ​
    22
    Use "instruqt [command] --help" for more information about a command.
    Copied!
  1. 1.
    Open a PowerShell window.
  2. 2.
    Copy and paste the following code:
    1
    mkdir scripts
    2
    cd scripts
    3
    [Environment]::SetEnvironmentVariable("Path", $env:Path + ";$($pwd.Path)", "User")
    4
    Invoke-WebRequest -Uri https://github.com/instruqt/cli/releases/download/2036-df08c03/instruqt-windows-2036-df08c03.zip -OutFile "instruqt.zip"
    5
    Expand-Archive instruqt.zip -d .
    6
    rm instruqt.zip
    Copied!
  3. 3.
    Close and re-open your Powershell window. ↳ This step refreshes your environment variables and detects the new program.
  4. 4.
    Enter the following command to check if Instruqt CLI was installed correctly:
    1
    instruqt
    Copied!
    ↳ You installed the Instruqt CLI correctly if you get the following output:
    1
    The instruqt SDK command line client is used to create and manage tracks.
    2
    ​
    3
    Usage:
    4
    instruqt [command]
    5
    ​
    6
    Available Commands:
    7
    active-users List all users playing an invite
    8
    auth Authentication commands.
    9
    challenge Create and manage challenges.
    10
    completion Generate shell auto completion scripts.
    11
    config View and edit Instruqt CLI configuration.
    12
    developer Manage the developers of a track.
    13
    help Help about any command
    14
    note Create and manage notes.
    15
    track Create and manage tracks
    16
    update Update the CLI.
    17
    version Show the version of the CLI.
    18
    ​
    19
    Flags:
    20
    -h, --help help for instruqt
    21
    ​
    22
    Use "instruqt [command] --help" for more information about a command.
    Copied!
Install a code editor
You also need to install a code editor like Visual Studio Code (VS Code) to edit the Instruqt configuration files. To install VS Code, follow these steps:
  1. 1.
    Download VS Code and follow the installation instructions for your platform.
  2. 2.
    Install the Markdown All In One extension in VS Code. This extension provides shortcuts and auto-completion for Markdown files.
You are ready now to build tracks.