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 | ||
| 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. | |
| 17 | ||
| 65c8d802 DM |
18 | `cipassword`: `<string>` :: |
| 19 | ||
| 20 | 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. | |
| 21 | ||
| 22 | `citype`: `<configdrive2 | nocloud>` :: | |
| 23 | ||
| 24 | 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. | |
| 25 | ||
| 26 | `ciuser`: `<string>` :: | |
| 27 | ||
| 28 | User name to change ssh keys and password for instead of the image's configured default user. | |
| 29 | ||
| 30 | `ipconfig[n]`: `[gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>]` :: | |
| 31 | ||
| 32 | Specify IP addresses and gateways for the corresponding interface. | |
| 33 | + | |
| 34 | IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified. | |
| 35 | + | |
| 4772952b TL |
36 | The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit |
| 37 | gateway should be provided. | |
| ac70d7d1 | 38 | For IPv6 the special string 'auto' can be used to use stateless autoconfiguration. |
| 65c8d802 | 39 | + |
| 4772952b TL |
40 | If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using |
| 41 | dhcp on IPv4. | |
| 65c8d802 DM |
42 | |
| 43 | `gw`=`<GatewayIPv4>` ;; | |
| 44 | ||
| 45 | Default gateway for IPv4 traffic. | |
| 46 | + | |
| 47 | NOTE: Requires option(s): `ip` | |
| 48 | ||
| 49 | `gw6`=`<GatewayIPv6>` ;; | |
| 50 | ||
| 51 | Default gateway for IPv6 traffic. | |
| 52 | + | |
| 53 | NOTE: Requires option(s): `ip6` | |
| 54 | ||
| 55 | `ip`=`<IPv4Format/CIDR>` ('default =' `dhcp`);; | |
| 56 | ||
| 57 | IPv4 address in CIDR format. | |
| 58 | ||
| 59 | `ip6`=`<IPv6Format/CIDR>` ('default =' `dhcp`);; | |
| 60 | ||
| 61 | IPv6 address in CIDR format. | |
| 62 | ||
| 63 | `nameserver`: `<string>` :: | |
| 64 | ||
| 4772952b TL |
65 | Sets DNS server IP address for a container. Create will' |
| 66 | .' automatically use the setting from the host if neither searchdomain nor nameserver' | |
| 67 | .' are set. | |
| 65c8d802 DM |
68 | |
| 69 | `searchdomain`: `<string>` :: | |
| 70 | ||
| 4772952b TL |
71 | Sets DNS search domains for a container. Create will' |
| 72 | .' automatically use the setting from the host if neither searchdomain nor nameserver' | |
| 73 | .' are set. | |
| 65c8d802 DM |
74 | |
| 75 | `sshkeys`: `<string>` :: | |
| 76 | ||
| 77 | Setup public SSH keys (one key per line, OpenSSH format). | |
| 78 |