What are Machine images?

A Machine image is an pre-baked image that contains all the necessary components installed. This is used to spin up minions for running your CI, RunSH & RunCLI jobs on it. Every subscription (org/team depending on SCM you use) has a default version of the machine image configured. This default is setup whenever the first CI or Pipeline job is configured.

The following picture shows the relationship between the build machine and the build container. The build container is spun up on the build machine using either the default Docker image depending the language tag in your yml configuration or a custom Docker image if specified in the yml.

Machine Image for a Subscription

We currently offer the following Machine Images. You can click on any one to see what is pre-installed on that image:

Machine Image Release date
v5.8.2 Aug 10, 2017
v5.7.3 Jul 20, 2017
v5.6.1 Jun 05, 2017
v5.5.1 Apr 26, 2017
v5.4.1 Mar 30, 2017
v5.3.2 Mar 11, 2017
Stable Feb 19, 2016 (deprecated)

The default Machine Image for your subscription is the latest image available when your Subscription was added to Shippable.

In most cases, the default Machine image set for your Subscription will be sufficient to run your builds. The main reasons why you might want to consider changing to a more recent image are:

  • You need a newer language/service/package version
  • You need a newer Docker version

Viewing Subscription Machine Image

To see what Machine Image is being used for your subscription, go to the Settings tab of your Subscription and click on Options in the left sidebar.

The top item on this page will show you the machine image currently being used:

Machine Image for a Subscription

Changing the Subscription Machine image

To select a different Machine Image:

  • Go to the Settings tab of your Subscription
  • Click on Options in the left sidebar and select the image you want from the dropdown under the 'Machine Images' section. Please note that this setting will affect all projects and builds in your Subscription.

Machine Image for a Subscription