Create and push your first track
This guide shows you how to create your first track using the CLI. This is what you'll do:
  1. 1.
    Use a template to create a local directory with track configuration files.
  2. 2.
    Push your local track to Instruqt
  3. 3.
    Play the track on Instruqt
Step 1: Create a track using one of the templates
To create a local directory with an example track:
  1. 1.
    Run instruqt track create
  2. 2.
    If the CLI prompts you for a track title, enter My first track and press Enter
  3. 3.
    Choose From a template
  4. 4.
    Select a template: Sandbox Container
You'll now find a directory my-first-track with the track configuration files. Run ls to check if the directory was created.
Step 2: Push the track to Instruqt
To play the track on Instruqt, you'll need to push (that is, upload) it to Instruqt first:
  1. 1.
    Change into the new directory with the track
  2. 2.
    To push the track, run instruqt track push
The push command will tell you it loads the track configuration files, checks them, and uploads them to Instruqt. If that was successful, it prints the Track URL.
Step 3: Play the lab on Instruqt
To open the track URL in your browser, you can copy and paste the Track URL, or run the open command:
  1. 1.
    Run instruqt track open from the track directory
  2. 2.
    Press Start track
  3. 3.
    While you wait, Instruqt starts all sandbox hosts and runs provisioning scripts on the hosts.
  4. 4.
    As soon as the sandbox is ready for you, a Start button appears. Press the Start button
  5. 5.
    You have access to the sandbox now. Solve the challenges until you finish the track!
Step 4: Edit the track and push your changes
Now that you've played the track, don't forget to explore the track configuration files.
  1. 1.
    Find the assigment.md file and change the text of the challenge assignment.
  2. 2.
    Save your changes and push the track.
  3. 3.
    If you're still playing the track, you can reload the page to view your changes (or start the track again)
Last modified 26d ago
Copy link