Skip to main content

Custom VM Images

WarpBuild allows you to use your own custom VM images in your custom runner configurations while running them on your own cloud. This is useful if you are using a custom VM image that you have built due to a specific need.

💡 Note: The "images" referred to in this section are VM images. This is distinct from the custom container images support.

Custom VMIs are only supported for BYOC. AWS is supported for BYOC and virtual machine images from AWS (AMIs) are supported. This support will be expanded once BYOC with GCP and Azure is rolled out.

VM Image requirements​

AMIs​

  1. Only Linux based AMIs are supported. Windows support will be added in the future.
  2. The Linux distro the image is based on should be using systemd. WarpBuild relies on it to run its agent.
  3. curl and wget should be present in the image.

Add the image​

  1. Setup a WarpBuild Stack
  2. Add a VM image using the Add Image button on the custom images page. All the images in the region the stack is in will be listed. Select the image you want to use. Add VM Image Add VM Image
  3. Create a custom runner using the image.
  4. Use the custom runner label in your workflows to run the jobs on this container image.

Pricing​

There is no additional cost for using custom VM images.