Add hosts

How to add virtual machines and containers to sandboxes.

Overview

Sandboxes support VMs and containers natively. Use the following points to determine if you should use one or the other.

You should use VMs if...

You should use containers if...

You want to make loading times as short as possible (they are generally faster to deploy)
You have a lightweight application with minimal resource requirements

You can use the web UI or Instruqt CLI to add VMs to a sandbox.

Select a track.
In the Sandbox section, click Edit.
In the Your hosts section, click + Add a host.
Select Virtual machine.
Enter a hostname.
Select Preset image or Choose your own.
- If you select Preset image, select the preset you wish to use.
- If you select Choose your own, provide a GCP image and machine type (see docs).
Define any additional settings you need.
- Shell
- External ingress
- SSL certificate
- Nested virtualization
Click Save host.

Within a track's config.yml file, VM hosts are defined like so:

virtualmachines:
- name: <hostname>
  image: <gcp_project>/<image_name>
  machine_type: <machine_size>

You can use the web UI or Instruqt CLI to add containers to a sandbox.

Select a track.
In the Sandbox section, click Edit.
In the Your hosts section, click + Add a host.
Select Container.
Enter a hostname.
Select Preset image or Choose your own.
- If you select Preset image, select the preset you wish to use.
- If you select Choose your own, provide a custom image (see docs).
Define any additional settings you need.
- Entrypoint
- Cmd
- Ports
- Shell
Click Save host.

Within a track's config.yml file, container hosts are defined like so:

containers:
- name: <hostname>
  image: <container_image>
  memory: <memory_ammount_mb>

Last updated 1 month ago