CoreOS Container Linux Logo

A container-focused OS that's designed for painless management in large clusters

Running CoreOS Container Linux on CloudStack

This guide explains how to deploy Container Linux with CloudStack. These instructions will walk you through downloading Container Linux image and running an instance from it. This document assumes that CloudStack is already installed. Please refer to the Install Guide for CloudStack installation steps.

Register the CoreOS Container Linux image (template)

After logging in to CloudStack UI, to upload a template:

  1. In the left navigation bar, click Templates.
  2. Click Register Template.
  3. Provide the following:
  • Name and Description: These will be shown in the UI, so choose something descriptive.
  • URL: The Management Server will download the file from the specified URL, such as
  • Zone: Choose the zone where you want the template to be available, or All Zones to make it available throughout CloudStack.
  • OS Type: This helps CloudStack and the hypervisor perform certain operations and make assumptions that improve the performance of the guest.
  • Hypervisor: The supported hypervisors are listed. Select the desired one.
  • Format: The format of the template upload file, such as VHD or OVA.
  • Extractable: Choose Yes if the template is available for extraction. If this option is selected, end users can download a full image of a template.
  • Public: Choose Yes to make this template accessible to all users of this CloudStack installation. The template will appear in the Community Templates list. See Container Linux Templates.
  • Featured: Choose Yes if you would like this template to be more prominent for users to select. The template will appear in the Featured Templates list. Only an administrator can make a template Featured.

Alternatively, the registerTemplate API can also be used.

CoreOS Container Linux templates

Apache CloudStack community created Container Linux templates are currently available for XenServer, KVM, VMware and HyperV hypervisors.

Deploy CoreOS Container Linux instance

To create a VM from a template:

  1. Log in to the CloudStack UI as an administrator or user.
  2. In the left navigation bar, click Instances.
  3. Click Add Instance.
  4. Select a zone.
  5. Select the Container Linux template registered in the previous step.
  6. Click Submit and your VM will be created and started.

Alternatively, the deployVirtualMachine API can also be used to deploy Container Linux instances.

Virtual machine configuration

cloud-config can be provided using userdata while deploying virtual machine. userdata is an optional request parameter for the deployVirtualMachine API.

Using CoreOS Container Linux

Now that you have a machine booted it is time to play around. Check out the Container Linux Quickstart guide or dig into more specific topics.