Skip to content
Official upstream for the cloud-init project.
Python Shell Makefile
Branch: master
Clone or download
igalic and raharper distro: correctly set usr_lib_exec path for FreeBSD distro (#40)
On FreeBSD our helpers live in /usr/local/lib/cloud-init/

LP: #1852491
Latest commit fb04493 Nov 13, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
bash_completion dhclient-hook: cleanups, tests and fix a bug on 'down' event. Dec 3, 2018
cloudinit distro: correctly set usr_lib_exec path for FreeBSD distro (#40) Nov 13, 2019
config Add support for Arch Linux in render-cloudcfg Oct 1, 2019
doc docs: touchups in rtd intro and Nov 7, 2019
packages packages: update rpm specs for new bash completion path Apr 19, 2019
systemd cloud-init.service: on centos/fedora/redhat wait on… Oct 31, 2019
sysvinit Gentoo: chmod +x on all files in sysvinit/gentoo/ Oct 31, 2017
templates templates/ntp.conf.debian.tmpl: fix missing newline for pools Jul 16, 2019
tests azure: support secondary ipv6 addresses (#33) Nov 13, 2019
tools lp-to-git-users: adding igalic Nov 13, 2019
udev azure: add udev rules to create cloud-init Gen2 disk name symlinks Nov 8, 2018
upstart cloud-init-blocknet: remove debug code going to /run/cloud-init-blocknet Sep 15, 2014
.gitignore Add .venv/ to .gitignore Oct 16, 2019
.pylintrc pylintrc: add 'enter_context' to generated-members list Sep 25, 2019
.travis.yml travis: only run CI on pull requests Nov 12, 2019
ChangeLog Release 19.3 Nov 5, 2019
HACKING.rst doc: update launchpad git refs to github Nov 7, 2019
LICENSE LICENSE: Allow dual licensing GPL-3 or Apache 2.0 Dec 22, 2016
LICENSE-Apache2.0 LICENSE: Allow dual licensing GPL-3 or Apache 2.0 Dec 22, 2016
LICENSE-GPLv3 LICENSE: Allow dual licensing GPL-3 or Apache 2.0 Dec 22, 2016 Implement bash completion script for cloud-init command line Apr 18, 2018
Makefile tools: make clean now cleans the dev directory, not the system Sep 18, 2019 docs: touchups in rtd intro and Nov 7, 2019
TODO.rst move TODO to TODO.rst Jul 7, 2014
integration-requirements.txt cloud_tests: updates and fixes Jul 18, 2019
requirements.txt Remove prettytable dependency, introduce simpletable Oct 2, 2017 install bash completion script in new location Apr 18, 2019
snapcraft.yaml snap: Removing snapcraft plug line Jun 7, 2017
test-requirements.txt tox/build: do not package depend on style requirements. May 24, 2017
tox.ini doc: document doc, create makefile and tox target Sep 7, 2019

Cloud-init official project upstream as of 11/2019

This repository is also mirrored to

Build Status Read the Docs

Cloud-init is the industry standard multi-distribution method for cross-platform cloud instance initialization. It is supported across all major public cloud providers, provisioning systems for private cloud infrastructure, and bare-metal installations.

Cloud instances are initialized from a disk image and instance data:

  • Cloud metadata
  • User data (optional)
  • Vendor data (optional)

Cloud-init will identify the cloud it is running on during boot, read any provided metadata from the cloud and initialize the system accordingly. This may involve setting up the network and storage devices to configuring SSH access key and many other aspects of a system. Later on the cloud-init will also parse and process any optional user or vendor data that was passed to the instance.

Getting involved

All contributions welcome! Submit code and docs by following our hacking guide

Getting help

Having trouble? We would like to help!

Recent cloud-init upstream releases

Upstream release version Release date
19.4 planned (2019-12-XX)
19.3 2019-11-05
19.2 2019-07-17
19.1 2019-05-10

Cloud-init distribution and cloud support

Note: Each linux distribution and cloud tracks cloud-init upstream updates at a different pace. If your distribution or cloud doesn't contain a recent cloud-init, suggest or propose an upgrade with your distribution of choice.

Supported OSes Supported Public Clouds Supported Private Clouds
Gentoo Linux

Amazon Web Services
Microsoft Azure
Google Cloud Platform
Oracle Cloud Infrastructure
Rackspace Public Cloud
IBM Cloud
Digital Ocean
Alibaba Cloud
Bare metal installs
Metal-as-a-Service (MAAS)

Daily Package Builds

We host daily Ubuntu Daily PPAs that build package for each Ubuntu series from tip of cloud-init.

For CentOS 7/8 we publish to a couple of COPR build repos:

You can’t perform that action at this time.