CoreOS Container Linux Logo

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

Cloud-Config Locations

NOTE: coreos-cloudinit is no longer under active development and has been superseded by Ignition. For more information about the recommended tools for provisioning Container Linux, refer to the provisioning documentation.

On every boot, coreos-cloudinit looks for a config file to configure your host. Here is a list of locations which are used by the Cloud-Config utility, depending on your CoreOS platform:

Location Description
/media/configvirtfs/openstack/latest/user_data /media/configvirtfs mount point with config-2 label. It should contain a openstack/latest/user_data relative path. Usually used by cloud providers or in VM installations.
/media/configdrive/openstack/latest/user_data FAT or ISO9660 filesystem with config-2 label and /media/configdrive/ mount point. It should also contain a openstack/latest/user_data relative path. Usually used in installations which are configured by USB Flash sticks or CDROM media.
Kernel command line: cloud-config-url= You can find this string using this command cat /proc/cmdline. Usually used in PXE or iPXE boots.
/var/lib/coreos-install/user_data When you install CoreOS manually using the coreos-install tool. Usually used in bare metal installations.
/usr/share/oem/cloud-config.yml Path for OEM images.
/var/lib/coreos-vagrant/vagrantfile-user-data Vagrant OEM scripts automatically store Cloud-Config into this path.
/var/lib/waagent/CustomData Azure platform uses OEM path for first Cloud-Config initialization and then /var/lib/waagent/CustomData to apply your settings. DigitalOcean, EC2 and Packet cloud providers correspondingly use these URLs to download Cloud-Config.
/usr/share/oem/bin/vmtoolsd --cmd "info-get" Cloud-Config provided by VMware Guestinfo
/usr/share/oem/bin/vmtoolsd --cmd "info-get guestinfo.coreos.config.url" Cloud-Config URL provided by VMware Guestinfo

You can also run the coreos-cloudinit tool manually and provide a path to your custom Cloud-Config file:

sudo coreos-cloudinit --from-file=/home/core/cloud-config.yaml

This command will apply your custom cloud-config.