Install CoreOS on Your Linode

Select distribution:
Traducciones al Español
Estamos traduciendo nuestros guías y tutoriales al Español. Es posible que usted esté viendo una traducción generada automáticamente. Estamos trabajando con traductores profesionales para verificar las traducciones de nuestro sitio web. Este proyecto es un trabajo en curso.

This guide has been deprecated and is no longer being maintained.

CoreOS Container Linux is now available for deployment from the Linode Manager.

CoreOS is a container-centric Linux distribution designed for clustered systems running in the cloud. With user applications running inside containers, the host system itself provides minimal functionality.

CoreOS is not officially supported by Linode so there are limitations to using it in comparison to the Linux images provided in the Linode Manager.

  • The CoreOS installer creates a partition table on the disk image which interferes with the Linode Backup service because the disk image is not be directly mountable.

  • Unlike the case with most partitioned images, you can resize the disk image holding a CoreOS system; however, it can only grow, not shrink. CoreOS resizes its root partition to fill the disk on next boot.

    These instructions perform destructive operations on your Linode! You should not attempt to install CoreOS on a Linode with data you want to preserve. You may wish to use a second Linode and transfer your data after installation.

Before You Begin

CoreOS configures no default way to log in except by supplying an option to the kernel command line. You should prepare a cloud-config file with authentication details for your first login. Should you forego this option, you can always add an SSH key through Lish after installation.

Prepare the Linode

  1. From the Linode Cloud Manager, create a new Linode.

  2. Under the Disks section of the Linode Dashboard, click on Create a new Disk:

  3. Label your new disk image and choose an appropriate size. You probably need to allocate at least 5 GB. Set the Type to unformatted / raw.

    If you’re not sure how big your disk image needs to be, you may wish to choose a small size so that you can grow the disk later. You can not shrink the disk image after it has been generated.

  4. Return to the Linode Dashboard and select the Rescue tab. Check to make sure the CoreOS disk image you created is set as /dev/sda and all other selectable devices set to –None–, then click the Reboot into Rescue Mode button. Your Linode now boots into the Finnix recovery image.

  5. Use Lish to access your Linode. From your Linode’s dashboard, click the Launch Console link to open an SSH connection in the local system’s terminal.

Collect Installation Files

These commands should be run from a root prompt under Finnix through Lish.

CoreOS can be installed using a self-contained script which automates the task of downloading an appropriate release image and copying it to disk.

  1. In order to securely download this script, it’s recommended to install the appropriate CA certificates from the Debian repositories:

    apt-get update
    apt-get install ca-certificates
  2. Now download the installation script from GitHub and mark it executable:

    chmod +x coreos-install

    You may wish to read the options available to install CoreOS:

    ./coreos-install -h

Cloud-Config File

The easiest way to copy your cloud-config file to your Linode is to simply cat > cloud-config.yml and paste into a text editor in your Lish shell. At minimum, you should have an authorized key for SSH access as shown below.

File: /cloud-config.yml
  - "example_public_ssh_key"

Install CoreOS to disk

  1. Run coreos-install on your disk image:

    ./coreos-install -v -d /dev/sda -c cloud-config.yml
    You can also supply any other options (see coreos-install -h). If you do not want verbose output, you can leave out the -v flag.
  2. ADVANCED: At this point, you can modify the image by mounting /dev/sda9. For example, you can make additions to your cloud-config file, you can add an authorized_keys for the core user as follows:

    mount /dev/sda9
    cat > /media/sda9/home/core/.ssh/authorized_keys <<EOF
    # ... ssh keys ...  EOF
  3. Power off your Linode.

    shutdown -h now

Configure your Linode to boot CoreOS

  1. Return to the Linode Dashboard and under Dashboard select Create a new Configuration Profile.

  2. Since CoreOS is installed with its own partition table and MBR, we cannot use the Linode-provided kernels. Under Boot Settings, click on the Kernel drop-down menu and select Direct Disk.

  3. Under Block Device Assignment, set /dev/sda to the CoreOS disk image you created and installed CoreOS to.

  4. All other settings can be left in their default state. Click Save Changes.

  5. Return to the Linode Dashboard, select the new configuration profile and click Reboot

Log in to CoreOS

  1. With Lish open, you should see your Linode booting into CoreOS, finishing with a list of SSH host keys and a login prompt, something similar to:

    This is li1010-4 (Linux x86_64 4.1.7-coreos-r1) 22:19:29
    SSH host key: 36:b5:e9:cd:8b:74:e9:52:fd:54:b1:30:78:af:f2:11 (DSA)
    SSH host key: 13:fe:66:49:35:35:5e:64:ae:4f:64:65:e2:98:8a:d4 (ED25519)
    SSH host key: 60:97:2c:b3:bf:2b:42:71:11:42:93:ff:ba:9f:ca:07 (RSA)
    eth0: 2001:db8:0:123::1
    li1010-4 login:
  2. You should now be able to access your Linode via SSH. If you did not specify a user in the cloud-config file, CoreOS’s default user is core. You should confirm that the host keys match the first time you log in, to reduce your risk from MITM attack.

More Information

You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.

This page was originally published on

Your Feedback Is Important

Let us know if this guide was helpful to you.

Join the conversation.
Read other comments or post your own below. Comments must be respectful, constructive, and relevant to the topic of the guide. Do not post external links or advertisements. Before posting, consider if your comment would be better addressed by contacting our Support team or asking on our Community Site.
The Disqus commenting system for Linode Docs requires the acceptance of Functional Cookies, which allow us to analyze site usage so we can measure and improve performance. To view and create comments for this article, please update your Cookie Preferences on this website and refresh this web page. Please note: You must have JavaScript enabled in your browser.