cloud-localds(1) cloud-utils cloud-localds(1)

cloud-localds - create a disk for cloud-init to utilize nocloud

cloud-localds [options] output user-data [meta-data]

cloud-localds creates a disk-image with user-data and/or meta-data for cloud-init(1). user-data can contain everything which is supported by cloud-init(1)

Disk format to output. See qemu-img(1) for allowed disk formats. Default is raw.
Filesystem format. Allowed formats are vfat and iso. Default is iso9660.
Show usage.
Write network interfaces file into metadata.
Add dsmode to the metadata. Allowed are local or net. Default in cloud-init(1) is net.

This example creates a disk image with user-data which can be used to start a cloud image which supports cloud-init(1).

cat > my-user-data <<EOF
password: passw0rd
chpasswd: { expire: False }
ssh_pwauth: True
cloud-localds my-seed.img my-user-data
qemu -net nic -net user -hda cloud-image.img -hdb my-seed.img -m 512

cloud-image.img is a image which supports cloud-init(1) during the boot process.

cloud-init(1), qemu-img(1), qemu(1)

This manpage was written by Thomas Bechtold <> for Debian systems (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 published by the Free Software Foundation.

July 2013 cloud-utils