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

Advanced referenceΒΆ

Settings that are documented in these pages are subject to change.

This documentation is intended for custom image creators, distribution maintainers, and cloud providers. Modifying these configurations should not be necessary for most end users and can result in a system that may be unreachable or may no longer boot.


  • Default configuration
  • Network configuration
  • Change cloud-config module run frequency
  • Merge cloud-config
  • Custom cloud-config modules
Next
Base configuration
Previous
WSL
Copyright © Canonical Group Ltd, 2026
Made with Sphinx and @pradyunsg's Furo