projects / pve-docs.git / blame
| Commit | Line | Data |
|---|---|---|
| 95895385 TL |
1 | `cicustom`: `[meta=<volume>] [,network=<volume>] [,user=<volume>]` :: |
| 2 | ||
| 3 | Specify custom files to replace the automatically generated ones at start. | |
| 4 | ||
| 5 | `meta`=`<volume>` ;; | |
| 6 | ||
| 7 | Specify a custom file containing all meta data passed to the VM via cloud-init. This is provider specific meaning configdrive2 and nocloud differ. | |
| 8 | ||
| 9 | `network`=`<volume>` ;; | |
| 10 | ||
| 11 | Specify a custom file containing all network data passed to the VM via cloud-init. | |
| 12 | ||
| 13 | `user`=`<volume>` ;; | |
| 14 | ||
| 15 | Specify a custom file containing all user data passed to the VM via cloud-init. | |
| 16 | ||
| 65c8d802 DM |
17 | `cipassword`: `<string>` :: |
| 18 | ||
| 19 | 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. | |
| 20 | ||
| 21 | `citype`: `<configdrive2 | nocloud>` :: | |
| 22 | ||
| 23 | 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. | |
| 24 | ||
| 25 | `ciuser`: `<string>` :: | |
| 26 | ||
| 27 | User name to change ssh keys and password for instead of the image's configured default user. | |
| 28 | ||
| 29 | `ipconfig[n]`: `[gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>]` :: | |
| 30 | ||
| 31 | Specify IP addresses and gateways for the corresponding interface. | |
| 32 | + | |
| 33 | IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified. | |
| 34 | + | |
| 35 | The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided. | |
| e2d681b3 | 36 | For IPv6 the special string 'auto' can be used to use stateless autoconfiguration. |
| 65c8d802 DM |
37 | + |
| 38 | If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4. | |
| 39 | ||
| 40 | `gw`=`<GatewayIPv4>` ;; | |
| 41 | ||
| 42 | Default gateway for IPv4 traffic. | |
| 43 | + | |
| 44 | NOTE: Requires option(s): `ip` | |
| 45 | ||
| 46 | `gw6`=`<GatewayIPv6>` ;; | |
| 47 | ||
| 48 | Default gateway for IPv6 traffic. | |
| 49 | + | |
| 50 | NOTE: Requires option(s): `ip6` | |
| 51 | ||
| 52 | `ip`=`<IPv4Format/CIDR>` ('default =' `dhcp`);; | |
| 53 | ||
| 54 | IPv4 address in CIDR format. | |
| 55 | ||
| 56 | `ip6`=`<IPv6Format/CIDR>` ('default =' `dhcp`);; | |
| 57 | ||
| 58 | IPv6 address in CIDR format. | |
| 59 | ||
| 60 | `nameserver`: `<string>` :: | |
| 61 | ||
| 62 | Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set. | |
| 63 | ||
| 64 | `searchdomain`: `<string>` :: | |
| 65 | ||
| 66 | Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set. | |
| 67 | ||
| 68 | `sshkeys`: `<string>` :: | |
| 69 | ||
| 70 | Setup public SSH keys (one key per line, OpenSSH format). | |
| 71 |