Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
cloud-init 25.3 documentation
Light Logo Dark Logo
cloud-init 25.3 documentation

Documentation

  • Tutorials
    • New user tutorial with QEMU
      • QEMU tutorial debugging
    • Quick-start tutorial with LXD
  • How-to guides
    • Validate user-data
    • Debug cloud-init
    • Check the status of cloud-init
    • Launch an instance using cloud-init
      • QEMU
      • LXD
      • Multipass
      • Libvirt
      • WSL
    • Wait for cloud-init
    • Re-run cloud-init
    • Disable cloud-init
    • Report a bug
  • Reference
    • Cloud-config
      • Cloud-config reference
      • Cloud-config examples
    • CLI
    • Logs
    • Datasources
      • Akamai
      • Alibaba Cloud (AliYun)
      • AltCloud
      • Amazon EC2
      • Azure
      • CloudCIX
      • CloudSigma
      • CloudStack
      • Config drive
      • DigitalOcean
      • Exoscale
      • Fallback/no datasource
      • Google Compute Engine
      • LXD
      • MAAS
      • NoCloud
      • None
      • NWCS
      • OpenNebula
      • OpenStack
      • Oracle
      • OVF
      • Rbx Cloud
      • Scaleway
      • SmartOS Datasource
      • UpCloud
      • VMware
      • Vultr
      • WSL
    • Advanced customization
      • Default configuration
      • Network configuration
        • Networking config Version 1
        • Networking config Version 2
      • Change cloud-config module run frequency
      • Merge cloud-config
      • Custom cloud-config modules
        • Custom Clean Scripts
        • Custom Configuration Module
        • Custom DataSource
        • Custom Mergers
        • Custom Part Handler
  • Explanation
    • Introduction
    • Configuration
      • Configuration priority
      • Configuration formats
        • Cloud-config
        • Boothook
        • User-data script
        • Include
        • Jinja
        • Gzip
        • Cloud-config archive
        • MIME
    • Boot stages
    • Failure modes
    • Project status
      • Breaking changes
      • Cloud and distro availability
      • Check out the latest code
      • Downstream LTS releases
      • Security policy
    • Hardening
    • FAQ
    • Advanced explanation
      • First boot determination
      • Manual cache cleaning
      • Events
      • Serial network output
      • Debug ds-identify
      • Custom part handlers

Development

  • Develop cloud-init
    • Develop code
      • About the tests
      • Support a new cloud
      • Run integration tests
      • Extend cloud-config
      • Find bugs to fix
    • Develop docs
      • Style guide
      • Directory layout
      • Find documentation issues
    • Read dev docs
      • Internal Files: data
      • Feature flags
      • Build system
      • Build a distro package from source
      • Directory layout
      • Logging
Back to top
View this page

ExplanationΒΆ

The following guides explain how cloud-init works.

  • Introduction
  • Configuration
  • Boot stages
  • Failure modes
  • Project status
  • Hardening
  • FAQ
  • Advanced explanation
Next
Introduction to cloud-init
Previous
Custom Part Handler
Copyright © Canonical Group Ltd, 2026
Made with Sphinx and @pradyunsg's Furo