Chapter 3. Red Hat support for cloud-init


Red Hat supports the cloud-init utility, cloud-init modules, default directories, and files across various Red Hat products.

3.1. Red Hat products that use cloud-init

You can use cloud-init with Red Hat OpenStack Platform, Red Hat Satellite, and Red Hat OpenShift to configure and initialize virtual machines.

3.2. Supported cloud-init modules

Red Hat supports most cloud-init modules. Each module can contain multiple configuration options and has a default module frequency that decides when it runs. The following table lists the supported cloud-init modules.

Expand
Table 3.1. Supported cloud-init modules
cloud-init ModuleDescriptionDefault Module Frequency

ansible

Runs Ansible playbooks

per instance

bootcmd

Runs commands at the early stage of the boot process

per always

ca_certs

Adds CA certificates

per instance

disable_ec2_metadata

Enables or disables the AWS EC2 metadata

per always

disk_setup

Configures simple partition tables and file systems

per instance

final_message

Specifies the output message once cloud-init completes

per always

growpart

Resizes partitions to fill the available disk space

per always

install_hotplug

Installs hot-plug devices

per instance

keys_to_console

Writes fingerprints and keys to the console

per instance

landscape

Installs and configures a landscape client

per instance

locale

Configures the system locale and applies it system-wide

per instance

rh_subscription

Registers a Red Hat Enterprise Linux (RHEL) system

per instance

rightscale_userdata

Adds support for RightScale configuration hooks to cloud-init

per instance

rsyslog

Configures remote system logging using rsyslog

per instance

runcmd

Runs arbitrary commands

per instance

salt_minion

Installs, configures, and starts salt minion

per instance

scripts_per_boot

Runs per boot scripts

per always

scripts_per_instance

Runs per instance scripts

per instance

scripts_per_once

Runs scripts once

per once

scripts_user

Runs user scripts

per instance

scripts_vendor

Runs vendor scripts

per instance

seed_random

Provides random seed data

per instance

set_hostname

Sets hostname and fully qualified domain name (FQDN)

per always

set_passwords

Sets user passwords and enables or disables SSH password authentication

per instance

spacewalk

Configures Spacewalk client

per instance

ssh_authkey_fingerprints

Logs fingerprints of user SSH keys

per instance

ssh_import_id

Imports SSH keys

per instance

ssh

Configures SSH, and host and authorized SSH keys

per instance

timezone

Sets the system time zone

per instance

update_etc_hosts

Updates /etc/hosts

per always

update_hostname

Updates hostname and FQDN

per always

users_groups

Configures users and groups

per instance

write_files

Writes arbitrary files

per instance

yum_add_repo

Adds dnf repository configuration to the system

per always

3.3. Cloud-init modules not supported by Red Hat

Red Hat does not support certain cloud-init modules, and using them in your cloud-init configuration is highly discouraged.

Expand
Table 3.2. Modules not supported
Module

apt_configure

apt_pipeline

byobu

chef

emit_upstart

grub_dpkg

ubuntu_init_switch

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top