Adding a Startup Script

Last updated 26 days ago

You can add a startup script to install additional software in your environment, download lesson files, or anything else you'd like.

Startup scripts must complete in under 60 seconds and run from the /tmp directory.

To add or modify your startup script, click the settings icon in the left side menu and scroll to the "Startup Script" section:

Begin each script with a hashbang statement (like #!/bin/bash). Keep in mind that your script will run each time the lesson loads, which may slow down lesson loading times.

If you're trying to install software using the startup script and running into issues, just let us know! We can add that software to the stack for you.

When a startup script is run, it will save three files to the starting directory (/root/sandbox by default):

  • .startup.stdout: The STDOUT from running the script (saved if there is any)

  • .startup.stderr: The STDERR from running the script (saved if there is any)

  • .startup.status: The status from running the script (saved if non-zero)

These files will be hidden from users by default because of the beginning of the file name.

Your startup script will run after any course-wide startup script.