Sandbox Hosts
This page describes sandbox hosts, the provisioning process of sandbox hosts, and support for choosing which host to use.
A sandbox host can be a container, a virtual machine or a website service, and you can add multiple hosts to a sandbox.
Before a learner can access the sandbox environment, Instruqt provisions all sandbox hosts. During provisioning, Instruqt starts the host and runs your setup scripts.
You can install your software packages and configuration on a sandbox host by using:
- Host-specific track setup scripts while the learner is waiting for the track to load
- Custom container images or Compute Engine machine images
Let's walk through the container and virtual machine provisioning process to make the most of these options.

To provision a container, Instruqt performs these steps:
- 1.Pull the image from a container registry like Docker Hub.
- 2.Start the container image to create a container.
- 3.Run the host-specific track setup script on the container.
- 4.Add the host to the sandbox.

To provision a virtual machine, Instruqt performs these steps:
- 1.Start a virtual machine using a Compute Engine machine image stored on Google Cloud.
- 2.Run the host-specific track setup script on the virtual machine.
- 3.Add the host to the sandbox.
To provision a website service, Instruqt performs these steps:
- 1.Starts a container with a browser inside it (predefined image).
- 2.Configures the browser to display the URL specified.
- 3.Add the host to the sandbox.
Instruqt supports using containers and virtual machines as sandbox hosts. Containers start faster, which means your learners start playing the track sooner. Reasons to choose a virtual machine over a container include:
- You need access to the Docker daemon to build container images and run containers.
- You require more than 8GB of system memory.
Long-running system services like databases or web servers
If you want to install long-running system services you can choose either a container or a virtual machine. However, since most base container images do not have a process manager, the experience is better on a virtual machine.
You can use the following custom and public image types:
Track setup scripts run while the learner is waiting for the track to load, and they are executed sequentially on all sandbox hosts. Check this topic for more information:
Last modified 1mo ago