Your first track

This guide shows you how to create your first track using the CLI. This is what you'll do:

  1. Install and authenticate the CLI

  2. Create local track configuration files

  3. Push your local track to Instruqt

  4. Play your first track!

Install and authenticate the CLI

Step 1: Download and install the CLI

  1. Download the latest release

  2. Extract the archive

  3. Move the binary to a location in your $PATH, for example:

    • /usr/local/bin

    • /usr/bin

  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. Run instruqt auth login in your terminal

  2. Open the generated URL in your browser

  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. Run instruqt track create

  2. Enter the title of your new track

  3. Choose[2] From a template

  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. Change into the new directory with the track

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