Man pages sections > man1 > cloud-localds

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

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)


-d, --disk_format=DISKFORMAT
Disk format to output. See qemu-img(1) for allowed disk formats. Default is raw.
-f, --filesystem=FORMAT
Filesystem format. Allowed formats are vfat and iso. Default is iso9660.
-h, --help
Show usage.
-i, --interfaces
Write network interfaces file into metadata.
-m, --dsmode=MODE
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).
Create some user-data:
cat > my-user-data <<EOF
password: passw0rd
chpasswd: { expire: False }
ssh_pwauth: True

Create the disk image which contains the user-data:
cloud-localds my-seed.img my-user-data

Boot the cloud-image:
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