Links

Create a track from scratch

Control everything right from the start.
This guide explains how to create a track from scratch from Web UI and Instruqt CLI.

Before you begin

Did you check the Build tracks page? This page sets you off for creating tracks.

Create track

Pick the Web UI or the Instruqt CLI route depending on your preference:
  1. 1.
    Open your browser and go to play.instruqt.com. ↳ Instruqt shows your content.
  2. 2.
    Click Create track. ↳ Instruqt shows the Start creating content page.
  3. 3.
    Click Create from scratch. ↳ Instruqt shows the Track details page.
  4. 4.
    In the Title field, enter the track title. ↳ As you enter the title, Instruqt automatically generates a slug in the Track slug field.
  5. 5.
    Leave the Track slug field as created by Instruqt or enter the slug of your liking.
  6. 6.
    Time limit This is the maximum time an end user can have the track up an running for
If you have changed the automatically created track slug and then update the title again, Instruqt regenerates the track slug.
7. In the Teaser field, enter the short track description.
Anywhere in this process, you can click **Back** to go back to earlier steps and make changes.
8. In the Editor tab of the Description field, enter the track description in Markdown.
Click the **Preview** tab to render your entered Markdown.
9. Click Next. ↳ Instruqt shows the Sandbox page, which __ gives you the option to: • Add a Docker container • Add a virtual machine • Skip this step
  1. 1.
    Choose one or more of the following options: — If **** you want to add a Docker container, click Add a Docker container:
1. In the **Hostname** field, enter a name for the host.
2. Select either the:
| Predefined image tab | Container image tab |
| ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <ol><li>Click the predefined image of your liking.</li></ol> | <ol><li>In the field <strong>Container image URL</strong>, <br>enter the URL.</li><li>In the <strong>Memory (MB)</strong> field, enter the <br>amount of memory you need.</li></ol> |
3. Click **Add container**.
4. Choose one of the following options:\
• If you are ready, click **Next**.\
• Or repeat these steps to add another Docker container.\
• Or continue with adding a virtual machine.
\
— If you want to add a virtual machine, click **Add a virtual machine:**
1. &#x20;In the **Hostname** field, enter a name for the host.
2. Select either the:
| Predefined image tab | Compute Engine image tab |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <ol><li>Click the predefined image of your liking.</li></ol> | <ol><li>In the field <strong>Compute Engine image</strong>, <br>enter the image name.</li><li>In the <strong>Machine type</strong> list, select the <br>machine you want to use.</li></ol> |
3. Click **Add container**.
4. Choose one of the following options:\
• If you are ready, click **Next**.\
• Or repeat these steps to add another virtual machine.
\
— If you do not want to add a Docker container or a virtual machine, click **Skip**.\
\
↳ Finally, after clicking **Next** or **Skip**, Instruqt shows the _Challenge page_.\
2. In the Title field, enter the challenge title. 12. In the Teaser field, enter the short challenge description. 13. Click Next. ↳ Instruqt shows the Challenge - Introduction page. 14. In the Select a type list, select the note type. 15. In the Editor tab of the Description field, enter the challenge description in Markdown.
Click the **Preview** tab to render your entered Markdown.
  1. 1.
    Click Next and Next again.
  2. 2.
    In the Editor tab of the Assignment field, enter the assignment text in Markdown.
Click the **Preview** tab to render your entered Markdown.
  1. 1.
    In the Tab title field, enter the name of the tab.
  2. 2.
    In the Tab type list, select the tab of your liking.
  3. 3.
    In the Sandbox host list, select one of the added Docker containers or virtual machines. Or leave the selection empty.
  4. 4.
    Click Next. ↳ Instruqt shows the Launch your track page.
  5. 5.
    Click Finish. ↳ Instruqt builds the track and shows the Track overview page.
  6. 6.
    Type the following command to create a track:
    instruqt track create
  7. 7.
    Enter the track title:
    ==> Track title: TRACK_TITLE
  8. 8.
    Enter option 1 to select From scratch:
    ==> Start with an empty track or use a template:
    [1] From scratch
    For full flexibility, start with an empty track
    [2] From a template
    To get started quickly, start from one of our templates
    Please select your method: 1
    ↳ Instruqt CLI creates the track and shows this output:
    ==> Creating track TEAM/TRACK_NAME
    ==> Creating track files
    Created track directory and configuration files:
    TRACK_NAME
    ├── config.yml
    └── track.yml
    OK
    TEAM and TRACK_TITLE will contain your team and track title.
Video tutorial
You can also watch this video tutorial for creating a track:
Well done! Now you can play your track to see if everything works as expected.