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