Cloud-Config Locations

NOTE: coreos-cloudinit is no longer under active development and has been superseded by [Ignition][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.