Your first track
This guide shows you how to create your first track using the CLI. This is what you'll do:
  1. 1.
    Install and authenticate the CLI
  2. 2.
    Create local track configuration files
  3. 3.
    Push your local track to Instruqt
  4. 4.
    Play your first track!

Install and authenticate the CLI

Step 1: Download and install the CLI

  1. 1.
    Download the latest release
  2. 2.
    Extract the archive
  3. 3.
    Move the binary to a location in your $PATH, for example:
    • /usr/local/bin
    • /usr/bin
  4. 4.
    To test if you can run the CLI, run the instruqt command in your terminal

Step 2: Authenticate the CLI

To start developing tracks with the CLI, authenticate your local install first
  1. 1.
    Run instruqt auth login in your terminal
  2. 2.
    Open the generated URL in your browser
  3. 3.
    Log in using your Instruqt credentials

Create and push your first track

Step 1: Create a track using one of the templates
To create a local directory with a track configuration:
  1. 1.
    Run instruqt track create
  2. 2.
    Enter the title of your new track
  3. 3.
    Choose[2] From a template
  4. 4.
    Select a template, for example [1] Sandbox Container
Step 2: Push the track to Instruqt
To play the track on Instruqt, push it first to the platform:
  1. 1.
    Change into the new directory with the track
  2. 2.
    Run instruqt track push in the track directory
Step 3: Play the lab on Instruqt
To open the track you've just pushed in your browser:
  1. 1.
    Run instruqt track open from the track directory
Step 4: Explore the source code
Now that you've played the track, don't forget to explore the track configuration files (find the reference here).

What's next

Last modified 4mo ago