2021-11-15 15:20:02 +01:00
`cicustom`: `[meta=<volume>] [,network=<volume>] [,user=<volume>] [,vendor=<volume>]` ::
2019-04-04 17:17:19 +02:00
Specify custom files to replace the automatically generated ones at start.
`meta`=`<volume>` ;;
2020-11-24 14:31:57 +01:00
Specify a custom file containing all meta data passed to the VM via"
." cloud-init. This is provider specific meaning configdrive2 and nocloud differ.
2019-04-04 17:17:19 +02:00
`network`=`<volume>` ;;
2023-03-20 19:55:17 +01:00
To pass a custom file containing all network data to the VM via cloud-init.
2019-04-04 17:17:19 +02:00
`user`=`<volume>` ;;
2023-03-20 19:55:17 +01:00
To pass a custom file containing all user data to the VM via cloud-init.
2021-11-15 15:20:02 +01:00
`vendor`=`<volume>` ;;
2023-03-20 19:55:17 +01:00
To pass a custom file containing all vendor data to the VM via cloud-init.
2019-04-04 17:17:19 +02:00
2018-05-14 11:50:14 +02:00
`cipassword`: `<string>` ::
Password to assign the user. Using this is generally not recommended. Use ssh keys instead. Also note that older cloud-init versions do not support hashed passwords.
2021-04-26 17:48:36 +02:00
`citype`: `<configdrive2 | nocloud | opennebula>` ::
2018-05-14 11:50:14 +02:00
Specifies the cloud-init configuration format. The default depends on the configured operating system type (`ostype`. We use the `nocloud` format for Linux, and `configdrive2` for windows.
2023-06-09 11:19:24 +02:00
`ciupgrade`: `<boolean>` ::
do an automatic package upgrade after the first boot.
2018-05-14 11:50:14 +02:00
`ciuser`: `<string>` ::
User name to change ssh keys and password for instead of the image's configured default user.
`ipconfig[n]`: `[gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>]` ::
Specify IP addresses and gateways for the corresponding interface.
+
IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.
+
2020-11-24 14:31:57 +01:00
The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit
gateway should be provided.
2021-04-26 17:48:36 +02:00
For IPv6 the special string 'auto' can be used to use stateless autoconfiguration. This requires
cloud-init 19.4 or newer.
2018-05-14 11:50:14 +02:00
+
2020-11-24 14:31:57 +01:00
If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using
dhcp on IPv4.
2018-05-14 11:50:14 +02:00
`gw`=`<GatewayIPv4>` ;;
Default gateway for IPv4 traffic.
+
NOTE: Requires option(s): `ip`
`gw6`=`<GatewayIPv6>` ;;
Default gateway for IPv6 traffic.
+
NOTE: Requires option(s): `ip6`
`ip`=`<IPv4Format/CIDR>` ('default =' `dhcp`);;
IPv4 address in CIDR format.
`ip6`=`<IPv6Format/CIDR>` ('default =' `dhcp`);;
IPv6 address in CIDR format.
`nameserver`: `<string>` ::
2022-09-12 17:25:00 +02:00
Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.
2018-05-14 11:50:14 +02:00
`searchdomain`: `<string>` ::
2022-09-12 17:25:00 +02:00
Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.
2018-05-14 11:50:14 +02:00
`sshkeys`: `<string>` ::
Setup public SSH keys (one key per line, OpenSSH format).