totp: fix copy/paste mistake

[pve-docs.git] / pct.1-synopsis.adoc

diff --git a/pct.1-synopsis.adoc b/pct.1-synopsis.adoc
index 433a1c1ae73bf70e6ff179d7f1d4dfb6888df0b5..47e830480f3cf79c9c17eaa6e026dda6cf0e5fb0 100644 (file)
--- a/pct.1-synopsis.adoc
+++ b/pct.1-synopsis.adoc
@@ -4,14 +4,18 @@
 
 Create a container clone/copy
 
 
 Create a container clone/copy
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 

-`<newid>`: `<integer> (1 - N)` ::
+`<newid>`: `<integer> (100 - 999999999)` ::

 
 VMID for the clone.
 
 
 VMID for the clone.
 

+`--bwlimit` `<number> (0 - N)` ('default =' `clone limit from datacenter or storage config`)::
+
+Override I/O bandwidth limit (in KiB/s).
+

 `--description` `<string>` ::
 
 Description for the new CT.
 `--description` `<string>` ::
 
 Description for the new CT.


@@ -32,7 +36,7 @@ Add the new CT to the specified pool.
 
 The name of the snapshot.
 
 
 The name of the snapshot.
 

-`--storage` `<string>` ::
+`--storage` `<storage ID>` ::

 
 Target storage for full clone.
 
 
 Target storage for full clone.
 


@@ -40,19 +44,27 @@ Target storage for full clone.
 
 Target node. Only allowed if the original VM is on shared storage.
 
 
 Target node. Only allowed if the original VM is on shared storage.
 

-*pct config* `<vmid>`
+*pct config* `<vmid>` `[OPTIONS]`

 
 Get container configuration.
 
 
 Get container configuration.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 

+`--current` `<boolean>` ('default =' `0`)::
+
+Get current values (instead of pending values).
+
+`--snapshot` `<string>` ::
+
+Fetch config values from given snapshot.
+

 *pct console* `<vmid>` `[OPTIONS]`
 
 Launch a console for the specified container.
 
 *pct console* `<vmid>` `[OPTIONS]`
 
 Launch a console for the specified container.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -68,7 +80,7 @@ Print the list of assigned CPU sets.
 
 Create or restore a container.
 
 
 Create or restore a container.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -76,13 +88,13 @@ The (unique) ID of the VM.
 
 The OS template or backup file.
 
 
 The OS template or backup file.
 

-`--arch` `<amd64 | arm64 | armhf | i386>` ('default =' `amd64`)::
+`--arch` `<amd64 | arm64 | armhf | i386 | riscv32 | riscv64>` ('default =' `amd64`)::

 
 OS architecture type.
 
 
 OS architecture type.
 

-`--bwlimit` `<number> (0 - N)` ::
+`--bwlimit` `<number> (0 - N)` ('default =' `restore limit from datacenter or storage config`)::

 
 

-Override i/o bandwidth limit (in KiB/s).
+Override I/O bandwidth limit (in KiB/s).

 
 `--cmode` `<console | shell | tty>` ('default =' `tty`)::
 
 
 `--cmode` `<console | shell | tty>` ('default =' `tty`)::
 


@@ -92,27 +104,33 @@ Console mode. By default, the console command tries to open a connection to one
 
 Attach a console device (/dev/console) to the container.
 
 
 Attach a console device (/dev/console) to the container.
 

-`--cores` `<integer> (1 - 128)` ::
+`--cores` `<integer> (1 - 8192)` ::

 
 The number of cores assigned to the container. A container can use all available cores by default.
 
 
 The number of cores assigned to the container. A container can use all available cores by default.
 

-`--cpulimit` `<number> (0 - 128)` ('default =' `0`)::
+`--cpulimit` `<number> (0 - 8192)` ('default =' `0`)::

 
 Limit of CPU usage.
 +
 NOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit.
 
 
 Limit of CPU usage.
 +
 NOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit.
 

-`--cpuunits` `<integer> (0 - 500000)` ('default =' `1024`)::
+`--cpuunits` `<integer> (0 - 500000)` ('default =' `cgroup v1: 1024, cgroup v2: 100`)::

 
 

-CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to the weights of all the other running VMs.
-+
-NOTE: You can disable fair-scheduler configuration by setting this to 0.
+CPU weight for a container, will be clamped to [1, 10000] in cgroup v2.
+
+`--debug` `<boolean>` ('default =' `0`)::
+
+Try to be more verbose. For now this only enables debug log-level on start.

 
 `--description` `<string>` ::
 
 
 `--description` `<string>` ::
 

-Container description. Only used on the configuration web interface.
+Description for the Container. Shown in the web-interface CT's summary. This is saved as comment inside the configuration file.

 
 

-`--features` `[fuse=<1|0>] [,keyctl=<1|0>] [,mount=<fstype;fstype;...>] [,nesting=<1|0>]` ::
+`--dev[n]` `[[path=]<Path>] [,gid=<integer>] [,mode=<Octal access mode>] [,uid=<integer>]` ::
+
+Device to pass through to the container
+
+`--features` `[force_rw_sys=<1|0>] [,fuse=<1|0>] [,keyctl=<1|0>] [,mknod=<1|0>] [,mount=<fstype;fstype;...>] [,nesting=<1|0>]` ::

 
 Allow containers access to advanced features.
 
 
 Allow containers access to advanced features.
 


@@ -120,6 +138,10 @@ Allow containers access to advanced features.
 
 Allow to overwrite existing container.
 
 
 Allow to overwrite existing container.
 

+`--hookscript` `<string>` ::
+
+Script that will be exectued during various steps in the containers lifetime.
+

 `--hostname` `<string>` ::
 
 Set a host name for the container.
 `--hostname` `<string>` ::
 
 Set a host name for the container.


@@ -128,31 +150,31 @@ Set a host name for the container.
 
 Ignore errors when extracting the template.
 
 
 Ignore errors when extracting the template.
 

-`--lock` `<backup | disk | migrate | mounted | rollback | snapshot | snapshot-delete>` ::
+`--lock` `<backup | create | destroyed | disk | fstrim | migrate | mounted | rollback | snapshot | snapshot-delete>` ::

 
 

-Lock/unlock the VM.
+Lock/unlock the container.

 
 `--memory` `<integer> (16 - N)` ('default =' `512`)::
 
 
 `--memory` `<integer> (16 - N)` ('default =' `512`)::
 

-Amount of RAM for the VM in MB.
+Amount of RAM for the container in MB.

 
 

-`--mp[n]` `[volume=]<volume> ,mp=<Path> [,acl=<1|0>] [,backup=<1|0>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::
+`--mp[n]` `[volume=]<volume> ,mp=<Path> [,acl=<1|0>] [,backup=<1|0>] [,mountoptions=<opt[;opt...]>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::

 
 

-Use volume as container mount point.
+Use volume as container mount point. Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume.

 
 `--nameserver` `<string>` ::
 
 Sets DNS server IP address for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
 
 
 `--nameserver` `<string>` ::
 
 Sets DNS server IP address for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
 

-`--net[n]` `name=<string> [,bridge=<bridge>] [,firewall=<1|0>] [,gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,hwaddr=<XX:XX:XX:XX:XX:XX>] [,ip=<(IPv4/CIDR|dhcp|manual)>] [,ip6=<(IPv6/CIDR|auto|dhcp|manual)>] [,mtu=<integer>] [,rate=<mbps>] [,tag=<integer>] [,trunks=<vlanid[;vlanid...]>] [,type=<veth>]` ::
+`--net[n]` `name=<string> [,bridge=<bridge>] [,firewall=<1|0>] [,gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,hwaddr=<XX:XX:XX:XX:XX:XX>] [,ip=<(IPv4/CIDR|dhcp|manual)>] [,ip6=<(IPv6/CIDR|auto|dhcp|manual)>] [,link_down=<1|0>] [,mtu=<integer>] [,rate=<mbps>] [,tag=<integer>] [,trunks=<vlanid[;vlanid...]>] [,type=<veth>]` ::

 
 Specifies network interfaces for the container.
 
 `--onboot` `<boolean>` ('default =' `0`)::
 
 
 Specifies network interfaces for the container.
 
 `--onboot` `<boolean>` ('default =' `0`)::
 

-Specifies whether a VM will be started during system bootup.
+Specifies whether a container will be started during system bootup.

 
 

-`--ostype` `<alpine | archlinux | centos | debian | fedora | gentoo | opensuse | ubuntu | unmanaged>` ::
+`--ostype` `<alpine | archlinux | centos | debian | devuan | fedora | gentoo | nixos | opensuse | ubuntu | unmanaged>` ::

 
 OS type. This is used to setup configuration inside the container, and corresponds to lxc setup scripts in /usr/share/lxc/config/<ostype>.common.conf. Value 'unmanaged' can be used to skip and OS specific setup.
 
 
 OS type. This is used to setup configuration inside the container, and corresponds to lxc setup scripts in /usr/share/lxc/config/<ostype>.common.conf. Value 'unmanaged' can be used to skip and OS specific setup.
 


@@ -172,7 +194,7 @@ Sets the protection flag of the container. This will prevent the CT or CT's disk
 
 Mark this as restore task.
 
 
 Mark this as restore task.
 

-`--rootfs` `[volume=]<volume> [,acl=<1|0>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::
+`--rootfs` `[volume=]<volume> [,acl=<1|0>] [,mountoptions=<opt[;opt...]>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::

 
 Use volume as container root.
 
 
 Use volume as container root.
 


@@ -192,27 +214,41 @@ Start the CT after its creation finished successfully.
 
 Startup and shutdown behavior. Order is a non-negative number defining the general startup order. Shutdown in done with reverse ordering. Additionally you can set the 'up' or 'down' delay in seconds, which specifies a delay to wait before the next VM is started or stopped.
 
 
 Startup and shutdown behavior. Order is a non-negative number defining the general startup order. Shutdown in done with reverse ordering. Additionally you can set the 'up' or 'down' delay in seconds, which specifies a delay to wait before the next VM is started or stopped.
 

-`--storage` `<string>` ('default =' `local`)::
+`--storage` `<storage ID>` ('default =' `local`)::

 
 Default Storage.
 
 `--swap` `<integer> (0 - N)` ('default =' `512`)::
 
 
 Default Storage.
 
 `--swap` `<integer> (0 - N)` ('default =' `512`)::
 

-Amount of SWAP for the VM in MB.
+Amount of SWAP for the container in MB.
+
+`--tags` `<string>` ::
+
+Tags of the Container. This is only meta information.

 
 `--template` `<boolean>` ('default =' `0`)::
 
 Enable/disable Template.
 
 
 `--template` `<boolean>` ('default =' `0`)::
 
 Enable/disable Template.
 

+`--timezone` `<string>` ::
+
+Time zone to use in the container. If option isn't set, then nothing will be done. Can be set to 'host' to match the host time zone, or an arbitrary time zone option from /usr/share/zoneinfo/zone.tab
+

 `--tty` `<integer> (0 - 6)` ('default =' `2`)::
 
 Specify the number of tty available to the container
 
 `--tty` `<integer> (0 - 6)` ('default =' `2`)::
 
 Specify the number of tty available to the container
 

+`--unique` `<boolean>` ::
+
+Assign a unique random ethernet address.
++
+NOTE: Requires option(s): `restore`
+

 `--unprivileged` `<boolean>` ('default =' `0`)::
 
 Makes the container run as unprivileged user. (Should not be modified manually.)
 
 `--unprivileged` `<boolean>` ('default =' `0`)::
 
 Makes the container run as unprivileged user. (Should not be modified manually.)
 

-`--unused[n]` `<string>` ::
+`--unused[n]` `[volume=]<volume>` ::

 
 Reference to unused volumes. This is used internally, and should not be modified manually.
 
 
 Reference to unused volumes. This is used internally, and should not be modified manually.
 


@@ -220,7 +256,7 @@ Reference to unused volumes. This is used internally, and should not be modified
 
 Delete a LXC snapshot.
 
 
 Delete a LXC snapshot.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -232,35 +268,51 @@ The name of the snapshot.
 
 For removal from config file, even if removing disk snapshots fails.
 
 
 For removal from config file, even if removing disk snapshots fails.
 

-*pct destroy* `<vmid>`
+*pct destroy* `<vmid>` `[OPTIONS]`

 
 Destroy the container (also delete all uses files).
 
 
 Destroy the container (also delete all uses files).
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 

+`--destroy-unreferenced-disks` `<boolean>` ::
+
+If set, destroy additionally all disks with the VMID from all enabled storages which are not referenced in the config.
+
+`--force` `<boolean>` ('default =' `0`)::
+
+Force destroy, even if running.
+
+`--purge` `<boolean>` ('default =' `0`)::
+
+Remove container from all related configurations. For example, backup jobs, replication jobs or HA. Related ACLs and Firewall entries will *always* be removed.
+

 *pct df* `<vmid>`
 
 Get the container's current disk usage.
 
 *pct df* `<vmid>`
 
 Get the container's current disk usage.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 

-*pct enter* `<vmid>`
+*pct enter* `<vmid>` `[OPTIONS]`

 
 Launch a shell for the specified container.
 
 
 Launch a shell for the specified container.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 

-*pct exec* `<vmid> [<extra-args>]`
+`--keep-env` `<boolean>` ('default =' `1`)::
+
+Keep the current environment. This option will disabled by default with PVE 9. If you rely on a preserved environment, please use this option to be future-proof.
+
+*pct exec* `<vmid> [<extra-args>]` `[OPTIONS]`

 
 Launch a command inside the specified container.
 
 
 Launch a command inside the specified container.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -268,11 +320,15 @@ The (unique) ID of the VM.
 
 Extra arguments as array
 
 
 Extra arguments as array
 

+`--keep-env` `<boolean>` ('default =' `1`)::
+
+Keep the current environment. This option will disabled by default with PVE 9. If you rely on a preserved environment, please use this option to be future-proof.
+

 *pct fsck* `<vmid>` `[OPTIONS]`
 
 Run a filesystem check (fsck) on a container volume.
 
 *pct fsck* `<vmid>` `[OPTIONS]`
 
 Run a filesystem check (fsck) on a container volume.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -284,6 +340,19 @@ A volume on which to run the filesystem check
 
 Force checking, even if the filesystem seems clean
 
 
 Force checking, even if the filesystem seems clean
 

+*pct fstrim* `<vmid>` `[OPTIONS]`
+
+Run fstrim on a chosen CT and its mountpoints, except bind or read-only
+mountpoints.
+
+`<vmid>`: `<integer> (100 - 999999999)` ::
+
+The (unique) ID of the VM.
+
+`--ignore-mountpoints` `<boolean>` ::
+
+Skip all mountpoints, only do fstrim on the container root.
+

 *pct help* `[OPTIONS]`
 
 Get help about specified command.
 *pct help* `[OPTIONS]`
 
 Get help about specified command.


@@ -304,7 +373,7 @@ LXC container index (per node).
 
 List all snapshots.
 
 
 List all snapshots.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -312,7 +381,7 @@ The (unique) ID of the VM.
 
 Migrate the container to another node. Creates a new migration task.
 
 
 Migrate the container to another node. Creates a new migration task.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -320,9 +389,9 @@ The (unique) ID of the VM.
 
 Target node.
 
 
 Target node.
 

-`--force` `<boolean>` ::
+`--bwlimit` `<number> (0 - N)` ('default =' `migrate limit from datacenter or storage config`)::

 
 

-Force migration despite local bind / device mounts. NOTE: deprecated, use 'shared' property of mount point instead.
+Override I/O bandwidth limit (in KiB/s).

 
 `--online` `<boolean>` ::
 
 
 `--online` `<boolean>` ::
 


@@ -332,6 +401,10 @@ Use online/live migration.
 
 Use restart migration
 
 
 Use restart migration
 

+`--target-storage` `<string>` ::
+
+Mapping from source to target storages. Providing only a single storage ID maps all source storages to that storage. Providing the special value '1' will map each source storage to itself.
+

 `--timeout` `<integer>` ('default =' `180`)::
 
 Timeout in seconds for shutdown for restart migration
 `--timeout` `<integer>` ('default =' `180`)::
 
 Timeout in seconds for shutdown for restart migration


@@ -342,39 +415,71 @@ Mount the container's filesystem on the host. This will hold a lock on the
 container and is meant for emergency maintenance only as it will prevent
 further operations on the container other than start and stop.
 
 container and is meant for emergency maintenance only as it will prevent
 further operations on the container other than start and stop.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 

-*pct move_volume* `<vmid> <volume> <storage>` `[OPTIONS]`
+*pct move-volume* `<vmid> <volume> [<storage>] [<target-vmid>] [<target-volume>]` `[OPTIONS]`

 
 

-Move a rootfs-/mp-volume to a different storage
+Move a rootfs-/mp-volume to a different storage or to a different
+container.

 
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 

-`<volume>`: `<mp0 | mp1 | mp10 | mp100 | mp101 | mp102 | mp103 | mp104 | mp105 | mp106 | mp107 | mp108 | mp109 | mp11 | mp110 | mp111 | mp112 | mp113 | mp114 | mp115 | mp116 | mp117 | mp118 | mp119 | mp12 | mp120 | mp121 | mp122 | mp123 | mp124 | mp125 | mp126 | mp127 | mp128 | mp129 | mp13 | mp130 | mp131 | mp132 | mp133 | mp134 | mp135 | mp136 | mp137 | mp138 | mp139 | mp14 | mp140 | mp141 | mp142 | mp143 | mp144 | mp145 | mp146 | mp147 | mp148 | mp149 | mp15 | mp150 | mp151 | mp152 | mp153 | mp154 | mp155 | mp156 | mp157 | mp158 | mp159 | mp16 | mp160 | mp161 | mp162 | mp163 | mp164 | mp165 | mp166 | mp167 | mp168 | mp169 | mp17 | mp170 | mp171 | mp172 | mp173 | mp174 | mp175 | mp176 | mp177 | mp178 | mp179 | mp18 | mp180 | mp181 | mp182 | mp183 | mp184 | mp185 | mp186 | mp187 | mp188 | mp189 | mp19 | mp190 | mp191 | mp192 | mp193 | mp194 | mp195 | mp196 | mp197 | mp198 | mp199 | mp2 | mp20 | mp200 | mp201 | mp202 | mp203 | mp204 | mp205 | mp206 | mp207 | mp208 | mp209 | mp21 | mp210 | mp211 | mp212 | mp213 | mp214 | mp215 | mp216 | mp217 | mp218 | mp219 | mp22 | mp220 | mp221 | mp222 | mp223 | mp224 | mp225 | mp226 | mp227 | mp228 | mp229 | mp23 | mp230 | mp231 | mp232 | mp233 | mp234 | mp235 | mp236 | mp237 | mp238 | mp239 | mp24 | mp240 | mp241 | mp242 | mp243 | mp244 | mp245 | mp246 | mp247 | mp248 | mp249 | mp25 | mp250 | mp251 | mp252 | mp253 | mp254 | mp255 | mp26 | mp27 | mp28 | mp29 | mp3 | mp30 | mp31 | mp32 | mp33 | mp34 | mp35 | mp36 | mp37 | mp38 | mp39 | mp4 | mp40 | mp41 | mp42 | mp43 | mp44 | mp45 | mp46 | mp47 | mp48 | mp49 | mp5 | mp50 | mp51 | mp52 | mp53 | mp54 | mp55 | mp56 | mp57 | mp58 | mp59 | mp6 | mp60 | mp61 | mp62 | mp63 | mp64 | mp65 | mp66 | mp67 | mp68 | mp69 | mp7 | mp70 | mp71 | mp72 | mp73 | mp74 | mp75 | mp76 | mp77 | mp78 | mp79 | mp8 | mp80 | mp81 | mp82 | mp83 | mp84 | mp85 | mp86 | mp87 | mp88 | mp89 | mp9 | mp90 | mp91 | mp92 | mp93 | mp94 | mp95 | mp96 | mp97 | mp98 | mp99 | rootfs>` ::
+`<volume>`: `<mp0 | mp1 | mp10 | mp100 | mp101 | mp102 | mp103 | mp104 | mp105 | mp106 | mp107 | mp108 | mp109 | mp11 | mp110 | mp111 | mp112 | mp113 | mp114 | mp115 | mp116 | mp117 | mp118 | mp119 | mp12 | mp120 | mp121 | mp122 | mp123 | mp124 | mp125 | mp126 | mp127 | mp128 | mp129 | mp13 | mp130 | mp131 | mp132 | mp133 | mp134 | mp135 | mp136 | mp137 | mp138 | mp139 | mp14 | mp140 | mp141 | mp142 | mp143 | mp144 | mp145 | mp146 | mp147 | mp148 | mp149 | mp15 | mp150 | mp151 | mp152 | mp153 | mp154 | mp155 | mp156 | mp157 | mp158 | mp159 | mp16 | mp160 | mp161 | mp162 | mp163 | mp164 | mp165 | mp166 | mp167 | mp168 | mp169 | mp17 | mp170 | mp171 | mp172 | mp173 | mp174 | mp175 | mp176 | mp177 | mp178 | mp179 | mp18 | mp180 | mp181 | mp182 | mp183 | mp184 | mp185 | mp186 | mp187 | mp188 | mp189 | mp19 | mp190 | mp191 | mp192 | mp193 | mp194 | mp195 | mp196 | mp197 | mp198 | mp199 | mp2 | mp20 | mp200 | mp201 | mp202 | mp203 | mp204 | mp205 | mp206 | mp207 | mp208 | mp209 | mp21 | mp210 | mp211 | mp212 | mp213 | mp214 | mp215 | mp216 | mp217 | mp218 | mp219 | mp22 | mp220 | mp221 | mp222 | mp223 | mp224 | mp225 | mp226 | mp227 | mp228 | mp229 | mp23 | mp230 | mp231 | mp232 | mp233 | mp234 | mp235 | mp236 | mp237 | mp238 | mp239 | mp24 | mp240 | mp241 | mp242 | mp243 | mp244 | mp245 | mp246 | mp247 | mp248 | mp249 | mp25 | mp250 | mp251 | mp252 | mp253 | mp254 | mp255 | mp26 | mp27 | mp28 | mp29 | mp3 | mp30 | mp31 | mp32 | mp33 | mp34 | mp35 | mp36 | mp37 | mp38 | mp39 | mp4 | mp40 | mp41 | mp42 | mp43 | mp44 | mp45 | mp46 | mp47 | mp48 | mp49 | mp5 | mp50 | mp51 | mp52 | mp53 | mp54 | mp55 | mp56 | mp57 | mp58 | mp59 | mp6 | mp60 | mp61 | mp62 | mp63 | mp64 | mp65 | mp66 | mp67 | mp68 | mp69 | mp7 | mp70 | mp71 | mp72 | mp73 | mp74 | mp75 | mp76 | mp77 | mp78 | mp79 | mp8 | mp80 | mp81 | mp82 | mp83 | mp84 | mp85 | mp86 | mp87 | mp88 | mp89 | mp9 | mp90 | mp91 | mp92 | mp93 | mp94 | mp95 | mp96 | mp97 | mp98 | mp99 | rootfs | unused0 | unused1 | unused10 | unused100 | unused101 | unused102 | unused103 | unused104 | unused105 | unused106 | unused107 | unused108 | unused109 | unused11 | unused110 | unused111 | unused112 | unused113 | unused114 | unused115 | unused116 | unused117 | unused118 | unused119 | unused12 | unused120 | unused121 | unused122 | unused123 | unused124 | unused125 | unused126 | unused127 | unused128 | unused129 | unused13 | unused130 | unused131 | unused132 | unused133 | unused134 | unused135 | unused136 | unused137 | unused138 | unused139 | unused14 | unused140 | unused141 | unused142 | unused143 | unused144 | unused145 | unused146 | unused147 | unused148 | unused149 | unused15 | unused150 | unused151 | unused152 | unused153 | unused154 | unused155 | unused156 | unused157 | unused158 | unused159 | unused16 | unused160 | unused161 | unused162 | unused163 | unused164 | unused165 | unused166 | unused167 | unused168 | unused169 | unused17 | unused170 | unused171 | unused172 | unused173 | unused174 | unused175 | unused176 | unused177 | unused178 | unused179 | unused18 | unused180 | unused181 | unused182 | unused183 | unused184 | unused185 | unused186 | unused187 | unused188 | unused189 | unused19 | unused190 | unused191 | unused192 | unused193 | unused194 | unused195 | unused196 | unused197 | unused198 | unused199 | unused2 | unused20 | unused200 | unused201 | unused202 | unused203 | unused204 | unused205 | unused206 | unused207 | unused208 | unused209 | unused21 | unused210 | unused211 | unused212 | unused213 | unused214 | unused215 | unused216 | unused217 | unused218 | unused219 | unused22 | unused220 | unused221 | unused222 | unused223 | unused224 | unused225 | unused226 | unused227 | unused228 | unused229 | unused23 | unused230 | unused231 | unused232 | unused233 | unused234 | unused235 | unused236 | unused237 | unused238 | unused239 | unused24 | unused240 | unused241 | unused242 | unused243 | unused244 | unused245 | unused246 | unused247 | unused248 | unused249 | unused25 | unused250 | unused251 | unused252 | unused253 | unused254 | unused255 | unused26 | unused27 | unused28 | unused29 | unused3 | unused30 | unused31 | unused32 | unused33 | unused34 | unused35 | unused36 | unused37 | unused38 | unused39 | unused4 | unused40 | unused41 | unused42 | unused43 | unused44 | unused45 | unused46 | unused47 | unused48 | unused49 | unused5 | unused50 | unused51 | unused52 | unused53 | unused54 | unused55 | unused56 | unused57 | unused58 | unused59 | unused6 | unused60 | unused61 | unused62 | unused63 | unused64 | unused65 | unused66 | unused67 | unused68 | unused69 | unused7 | unused70 | unused71 | unused72 | unused73 | unused74 | unused75 | unused76 | unused77 | unused78 | unused79 | unused8 | unused80 | unused81 | unused82 | unused83 | unused84 | unused85 | unused86 | unused87 | unused88 | unused89 | unused9 | unused90 | unused91 | unused92 | unused93 | unused94 | unused95 | unused96 | unused97 | unused98 | unused99>` ::

 
 Volume which will be moved.
 
 
 Volume which will be moved.
 

-`<storage>`: `<string>` ::
+`<storage>`: `<storage ID>` ::

 
 Target Storage.
 
 
 Target Storage.
 

+`<target-vmid>`: `<integer> (100 - 999999999)` ::
+
+The (unique) ID of the VM.
+
+`<target-volume>`: `<mp0 | mp1 | mp10 | mp100 | mp101 | mp102 | mp103 | mp104 | mp105 | mp106 | mp107 | mp108 | mp109 | mp11 | mp110 | mp111 | mp112 | mp113 | mp114 | mp115 | mp116 | mp117 | mp118 | mp119 | mp12 | mp120 | mp121 | mp122 | mp123 | mp124 | mp125 | mp126 | mp127 | mp128 | mp129 | mp13 | mp130 | mp131 | mp132 | mp133 | mp134 | mp135 | mp136 | mp137 | mp138 | mp139 | mp14 | mp140 | mp141 | mp142 | mp143 | mp144 | mp145 | mp146 | mp147 | mp148 | mp149 | mp15 | mp150 | mp151 | mp152 | mp153 | mp154 | mp155 | mp156 | mp157 | mp158 | mp159 | mp16 | mp160 | mp161 | mp162 | mp163 | mp164 | mp165 | mp166 | mp167 | mp168 | mp169 | mp17 | mp170 | mp171 | mp172 | mp173 | mp174 | mp175 | mp176 | mp177 | mp178 | mp179 | mp18 | mp180 | mp181 | mp182 | mp183 | mp184 | mp185 | mp186 | mp187 | mp188 | mp189 | mp19 | mp190 | mp191 | mp192 | mp193 | mp194 | mp195 | mp196 | mp197 | mp198 | mp199 | mp2 | mp20 | mp200 | mp201 | mp202 | mp203 | mp204 | mp205 | mp206 | mp207 | mp208 | mp209 | mp21 | mp210 | mp211 | mp212 | mp213 | mp214 | mp215 | mp216 | mp217 | mp218 | mp219 | mp22 | mp220 | mp221 | mp222 | mp223 | mp224 | mp225 | mp226 | mp227 | mp228 | mp229 | mp23 | mp230 | mp231 | mp232 | mp233 | mp234 | mp235 | mp236 | mp237 | mp238 | mp239 | mp24 | mp240 | mp241 | mp242 | mp243 | mp244 | mp245 | mp246 | mp247 | mp248 | mp249 | mp25 | mp250 | mp251 | mp252 | mp253 | mp254 | mp255 | mp26 | mp27 | mp28 | mp29 | mp3 | mp30 | mp31 | mp32 | mp33 | mp34 | mp35 | mp36 | mp37 | mp38 | mp39 | mp4 | mp40 | mp41 | mp42 | mp43 | mp44 | mp45 | mp46 | mp47 | mp48 | mp49 | mp5 | mp50 | mp51 | mp52 | mp53 | mp54 | mp55 | mp56 | mp57 | mp58 | mp59 | mp6 | mp60 | mp61 | mp62 | mp63 | mp64 | mp65 | mp66 | mp67 | mp68 | mp69 | mp7 | mp70 | mp71 | mp72 | mp73 | mp74 | mp75 | mp76 | mp77 | mp78 | mp79 | mp8 | mp80 | mp81 | mp82 | mp83 | mp84 | mp85 | mp86 | mp87 | mp88 | mp89 | mp9 | mp90 | mp91 | mp92 | mp93 | mp94 | mp95 | mp96 | mp97 | mp98 | mp99 | rootfs | unused0 | unused1 | unused10 | unused100 | unused101 | unused102 | unused103 | unused104 | unused105 | unused106 | unused107 | unused108 | unused109 | unused11 | unused110 | unused111 | unused112 | unused113 | unused114 | unused115 | unused116 | unused117 | unused118 | unused119 | unused12 | unused120 | unused121 | unused122 | unused123 | unused124 | unused125 | unused126 | unused127 | unused128 | unused129 | unused13 | unused130 | unused131 | unused132 | unused133 | unused134 | unused135 | unused136 | unused137 | unused138 | unused139 | unused14 | unused140 | unused141 | unused142 | unused143 | unused144 | unused145 | unused146 | unused147 | unused148 | unused149 | unused15 | unused150 | unused151 | unused152 | unused153 | unused154 | unused155 | unused156 | unused157 | unused158 | unused159 | unused16 | unused160 | unused161 | unused162 | unused163 | unused164 | unused165 | unused166 | unused167 | unused168 | unused169 | unused17 | unused170 | unused171 | unused172 | unused173 | unused174 | unused175 | unused176 | unused177 | unused178 | unused179 | unused18 | unused180 | unused181 | unused182 | unused183 | unused184 | unused185 | unused186 | unused187 | unused188 | unused189 | unused19 | unused190 | unused191 | unused192 | unused193 | unused194 | unused195 | unused196 | unused197 | unused198 | unused199 | unused2 | unused20 | unused200 | unused201 | unused202 | unused203 | unused204 | unused205 | unused206 | unused207 | unused208 | unused209 | unused21 | unused210 | unused211 | unused212 | unused213 | unused214 | unused215 | unused216 | unused217 | unused218 | unused219 | unused22 | unused220 | unused221 | unused222 | unused223 | unused224 | unused225 | unused226 | unused227 | unused228 | unused229 | unused23 | unused230 | unused231 | unused232 | unused233 | unused234 | unused235 | unused236 | unused237 | unused238 | unused239 | unused24 | unused240 | unused241 | unused242 | unused243 | unused244 | unused245 | unused246 | unused247 | unused248 | unused249 | unused25 | unused250 | unused251 | unused252 | unused253 | unused254 | unused255 | unused26 | unused27 | unused28 | unused29 | unused3 | unused30 | unused31 | unused32 | unused33 | unused34 | unused35 | unused36 | unused37 | unused38 | unused39 | unused4 | unused40 | unused41 | unused42 | unused43 | unused44 | unused45 | unused46 | unused47 | unused48 | unused49 | unused5 | unused50 | unused51 | unused52 | unused53 | unused54 | unused55 | unused56 | unused57 | unused58 | unused59 | unused6 | unused60 | unused61 | unused62 | unused63 | unused64 | unused65 | unused66 | unused67 | unused68 | unused69 | unused7 | unused70 | unused71 | unused72 | unused73 | unused74 | unused75 | unused76 | unused77 | unused78 | unused79 | unused8 | unused80 | unused81 | unused82 | unused83 | unused84 | unused85 | unused86 | unused87 | unused88 | unused89 | unused9 | unused90 | unused91 | unused92 | unused93 | unused94 | unused95 | unused96 | unused97 | unused98 | unused99>` ::
+
+The config key the volume will be moved to. Default is the source volume key.
+
+`--bwlimit` `<number> (0 - N)` ('default =' `clone limit from datacenter or storage config`)::
+
+Override I/O bandwidth limit (in KiB/s).
+

 `--delete` `<boolean>` ('default =' `0`)::
 
 Delete the original volume after successful copy. By default the original is kept as an unused volume entry.
 
 `--digest` `<string>` ::
 
 `--delete` `<boolean>` ('default =' `0`)::
 
 Delete the original volume after successful copy. By default the original is kept as an unused volume entry.
 
 `--digest` `<string>` ::
 

-Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
+Prevent changes if current configuration file has different SHA1 " .
+                   "digest. This can be used to prevent concurrent modifications.
+
+`--target-digest` `<string>` ::
+
+Prevent changes if current configuration file of the target " .
+                   "container has a different SHA1 digest. This can be used to prevent " .
+                   "concurrent modifications.
+
+*pct move_volume*
+
+An alias for 'pct move-volume'.
+
+*pct pending* `<vmid>`
+
+Get container configuration, including pending changes.
+
+`<vmid>`: `<integer> (100 - 999999999)` ::
+
+The (unique) ID of the VM.

 
 *pct pull* `<vmid> <path> <destination>` `[OPTIONS]`
 
 Copy a file from the container to the local system.
 
 
 *pct pull* `<vmid> <path> <destination>` `[OPTIONS]`
 
 Copy a file from the container to the local system.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -402,7 +507,7 @@ Owner user name or id.
 
 Copy a local file to the container.
 
 
 Copy a local file to the container.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -426,6 +531,64 @@ File permissions to use (octal by default, prefix with '0x' for hexadecimal).
 
 Owner user name or id. When using a name it must exist inside the container.
 
 
 Owner user name or id. When using a name it must exist inside the container.
 

+*pct reboot* `<vmid>` `[OPTIONS]`
+
+Reboot the container by shutting it down, and starting it again. Applies
+pending changes.
+
+`<vmid>`: `<integer> (100 - 999999999)` ::
+
+The (unique) ID of the VM.
+
+`--timeout` `<integer> (0 - N)` ::
+
+Wait maximal timeout seconds for the shutdown.
+
+*pct remote-migrate* `<vmid> [<target-vmid>] <target-endpoint> --target-bridge <string> --target-storage <string>` `[OPTIONS]`
+
+Migrate container to a remote cluster. Creates a new migration task.
+EXPERIMENTAL feature!
+
+`<vmid>`: `<integer> (100 - 999999999)` ::
+
+The (unique) ID of the VM.
+
+`<target-vmid>`: `<integer> (100 - 999999999)` ::
+
+The (unique) ID of the VM.
+
+`<target-endpoint>`: `apitoken=<PVEAPIToken=user@realm!token=SECRET> ,host=<ADDRESS> [,fingerprint=<FINGERPRINT>] [,port=<PORT>]` ::
+
+Remote target endpoint
+
+`--bwlimit` `<integer> (0 - N)` ('default =' `migrate limit from datacenter or storage config`)::
+
+Override I/O bandwidth limit (in KiB/s).
+
+`--delete` `<boolean>` ('default =' `0`)::
+
+Delete the original CT and related data after successful migration. By default the original CT is kept on the source cluster in a stopped state.
+
+`--online` `<boolean>` ::
+
+Use online/live migration.
+
+`--restart` `<boolean>` ::
+
+Use restart migration
+
+`--target-bridge` `<string>` ::
+
+Mapping from source to target bridges. Providing only a single bridge ID maps all source bridges to that bridge. Providing the special value '1' will map each source bridge to itself.
+
+`--target-storage` `<string>` ::
+
+Mapping from source to target storages. Providing only a single storage ID maps all source storages to that storage. Providing the special value '1' will map each source storage to itself.
+
+`--timeout` `<integer>` ('default =' `180`)::
+
+Timeout in seconds for shutdown for restart migration
+

 *pct rescan* `[OPTIONS]`
 
 Rescan all storages and update disk sizes and unused disk images.
 *pct rescan* `[OPTIONS]`
 
 Rescan all storages and update disk sizes and unused disk images.


@@ -434,7 +597,7 @@ Rescan all storages and update disk sizes and unused disk images.
 
 Do not actually write changes out to conifg.
 
 
 Do not actually write changes out to conifg.
 

-`--vmid` `<integer> (1 - N)` ::
+`--vmid` `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -442,7 +605,7 @@ The (unique) ID of the VM.
 
 Resize a container mount point.
 
 
 Resize a container mount point.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -462,7 +625,7 @@ Prevent changes if current configuration file has different SHA1 digest. This ca
 
 Create or restore a container.
 
 
 Create or restore a container.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -470,13 +633,13 @@ The (unique) ID of the VM.
 
 The OS template or backup file.
 
 
 The OS template or backup file.
 

-`--arch` `<amd64 | arm64 | armhf | i386>` ('default =' `amd64`)::
+`--arch` `<amd64 | arm64 | armhf | i386 | riscv32 | riscv64>` ('default =' `amd64`)::

 
 OS architecture type.
 
 
 OS architecture type.
 

-`--bwlimit` `<number> (0 - N)` ::
+`--bwlimit` `<number> (0 - N)` ('default =' `restore limit from datacenter or storage config`)::

 
 

-Override i/o bandwidth limit (in KiB/s).
+Override I/O bandwidth limit (in KiB/s).

 
 `--cmode` `<console | shell | tty>` ('default =' `tty`)::
 
 
 `--cmode` `<console | shell | tty>` ('default =' `tty`)::
 


@@ -486,27 +649,33 @@ Console mode. By default, the console command tries to open a connection to one
 
 Attach a console device (/dev/console) to the container.
 
 
 Attach a console device (/dev/console) to the container.
 

-`--cores` `<integer> (1 - 128)` ::
+`--cores` `<integer> (1 - 8192)` ::

 
 The number of cores assigned to the container. A container can use all available cores by default.
 
 
 The number of cores assigned to the container. A container can use all available cores by default.
 

-`--cpulimit` `<number> (0 - 128)` ('default =' `0`)::
+`--cpulimit` `<number> (0 - 8192)` ('default =' `0`)::

 
 Limit of CPU usage.
 +
 NOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit.
 
 
 Limit of CPU usage.
 +
 NOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit.
 

-`--cpuunits` `<integer> (0 - 500000)` ('default =' `1024`)::
+`--cpuunits` `<integer> (0 - 500000)` ('default =' `cgroup v1: 1024, cgroup v2: 100`)::

 
 

-CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to the weights of all the other running VMs.
-+
-NOTE: You can disable fair-scheduler configuration by setting this to 0.
+CPU weight for a container, will be clamped to [1, 10000] in cgroup v2.
+
+`--debug` `<boolean>` ('default =' `0`)::
+
+Try to be more verbose. For now this only enables debug log-level on start.

 
 `--description` `<string>` ::
 
 
 `--description` `<string>` ::
 

-Container description. Only used on the configuration web interface.
+Description for the Container. Shown in the web-interface CT's summary. This is saved as comment inside the configuration file.
+
+`--dev[n]` `[[path=]<Path>] [,gid=<integer>] [,mode=<Octal access mode>] [,uid=<integer>]` ::

 
 

-`--features` `[fuse=<1|0>] [,keyctl=<1|0>] [,mount=<fstype;fstype;...>] [,nesting=<1|0>]` ::
+Device to pass through to the container
+
+`--features` `[force_rw_sys=<1|0>] [,fuse=<1|0>] [,keyctl=<1|0>] [,mknod=<1|0>] [,mount=<fstype;fstype;...>] [,nesting=<1|0>]` ::

 
 Allow containers access to advanced features.
 
 
 Allow containers access to advanced features.
 


@@ -514,6 +683,10 @@ Allow containers access to advanced features.
 
 Allow to overwrite existing container.
 
 
 Allow to overwrite existing container.
 

+`--hookscript` `<string>` ::
+
+Script that will be exectued during various steps in the containers lifetime.
+

 `--hostname` `<string>` ::
 
 Set a host name for the container.
 `--hostname` `<string>` ::
 
 Set a host name for the container.


@@ -522,31 +695,31 @@ Set a host name for the container.
 
 Ignore errors when extracting the template.
 
 
 Ignore errors when extracting the template.
 

-`--lock` `<backup | disk | migrate | mounted | rollback | snapshot | snapshot-delete>` ::
+`--lock` `<backup | create | destroyed | disk | fstrim | migrate | mounted | rollback | snapshot | snapshot-delete>` ::

 
 

-Lock/unlock the VM.
+Lock/unlock the container.

 
 `--memory` `<integer> (16 - N)` ('default =' `512`)::
 
 
 `--memory` `<integer> (16 - N)` ('default =' `512`)::
 

-Amount of RAM for the VM in MB.
+Amount of RAM for the container in MB.

 
 

-`--mp[n]` `[volume=]<volume> ,mp=<Path> [,acl=<1|0>] [,backup=<1|0>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::
+`--mp[n]` `[volume=]<volume> ,mp=<Path> [,acl=<1|0>] [,backup=<1|0>] [,mountoptions=<opt[;opt...]>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::

 
 

-Use volume as container mount point.
+Use volume as container mount point. Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume.

 
 `--nameserver` `<string>` ::
 
 Sets DNS server IP address for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
 
 
 `--nameserver` `<string>` ::
 
 Sets DNS server IP address for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
 

-`--net[n]` `name=<string> [,bridge=<bridge>] [,firewall=<1|0>] [,gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,hwaddr=<XX:XX:XX:XX:XX:XX>] [,ip=<(IPv4/CIDR|dhcp|manual)>] [,ip6=<(IPv6/CIDR|auto|dhcp|manual)>] [,mtu=<integer>] [,rate=<mbps>] [,tag=<integer>] [,trunks=<vlanid[;vlanid...]>] [,type=<veth>]` ::
+`--net[n]` `name=<string> [,bridge=<bridge>] [,firewall=<1|0>] [,gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,hwaddr=<XX:XX:XX:XX:XX:XX>] [,ip=<(IPv4/CIDR|dhcp|manual)>] [,ip6=<(IPv6/CIDR|auto|dhcp|manual)>] [,link_down=<1|0>] [,mtu=<integer>] [,rate=<mbps>] [,tag=<integer>] [,trunks=<vlanid[;vlanid...]>] [,type=<veth>]` ::

 
 Specifies network interfaces for the container.
 
 `--onboot` `<boolean>` ('default =' `0`)::
 
 
 Specifies network interfaces for the container.
 
 `--onboot` `<boolean>` ('default =' `0`)::
 

-Specifies whether a VM will be started during system bootup.
+Specifies whether a container will be started during system bootup.

 
 

-`--ostype` `<alpine | archlinux | centos | debian | fedora | gentoo | opensuse | ubuntu | unmanaged>` ::
+`--ostype` `<alpine | archlinux | centos | debian | devuan | fedora | gentoo | nixos | opensuse | ubuntu | unmanaged>` ::

 
 OS type. This is used to setup configuration inside the container, and corresponds to lxc setup scripts in /usr/share/lxc/config/<ostype>.common.conf. Value 'unmanaged' can be used to skip and OS specific setup.
 
 
 OS type. This is used to setup configuration inside the container, and corresponds to lxc setup scripts in /usr/share/lxc/config/<ostype>.common.conf. Value 'unmanaged' can be used to skip and OS specific setup.
 


@@ -562,7 +735,7 @@ Add the VM to the specified pool.
 
 Sets the protection flag of the container. This will prevent the CT or CT's disk remove/update operation.
 
 
 Sets the protection flag of the container. This will prevent the CT or CT's disk remove/update operation.
 

-`--rootfs` `[volume=]<volume> [,acl=<1|0>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::
+`--rootfs` `[volume=]<volume> [,acl=<1|0>] [,mountoptions=<opt[;opt...]>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::

 
 Use volume as container root.
 
 
 Use volume as container root.
 


@@ -582,27 +755,41 @@ Start the CT after its creation finished successfully.
 
 Startup and shutdown behavior. Order is a non-negative number defining the general startup order. Shutdown in done with reverse ordering. Additionally you can set the 'up' or 'down' delay in seconds, which specifies a delay to wait before the next VM is started or stopped.
 
 
 Startup and shutdown behavior. Order is a non-negative number defining the general startup order. Shutdown in done with reverse ordering. Additionally you can set the 'up' or 'down' delay in seconds, which specifies a delay to wait before the next VM is started or stopped.
 

-`--storage` `<string>` ('default =' `local`)::
+`--storage` `<storage ID>` ('default =' `local`)::

 
 Default Storage.
 
 `--swap` `<integer> (0 - N)` ('default =' `512`)::
 
 
 Default Storage.
 
 `--swap` `<integer> (0 - N)` ('default =' `512`)::
 

-Amount of SWAP for the VM in MB.
+Amount of SWAP for the container in MB.
+
+`--tags` `<string>` ::
+
+Tags of the Container. This is only meta information.

 
 `--template` `<boolean>` ('default =' `0`)::
 
 Enable/disable Template.
 
 
 `--template` `<boolean>` ('default =' `0`)::
 
 Enable/disable Template.
 

+`--timezone` `<string>` ::
+
+Time zone to use in the container. If option isn't set, then nothing will be done. Can be set to 'host' to match the host time zone, or an arbitrary time zone option from /usr/share/zoneinfo/zone.tab
+

 `--tty` `<integer> (0 - 6)` ('default =' `2`)::
 
 Specify the number of tty available to the container
 
 `--tty` `<integer> (0 - 6)` ('default =' `2`)::
 
 Specify the number of tty available to the container
 

+`--unique` `<boolean>` ::
+
+Assign a unique random ethernet address.
++
+NOTE: Requires option(s): `restore`
+

 `--unprivileged` `<boolean>` ('default =' `0`)::
 
 Makes the container run as unprivileged user. (Should not be modified manually.)
 
 `--unprivileged` `<boolean>` ('default =' `0`)::
 
 Makes the container run as unprivileged user. (Should not be modified manually.)
 

-`--unused[n]` `<string>` ::
+`--unused[n]` `[volume=]<volume>` ::

 
 Reference to unused volumes. This is used internally, and should not be modified manually.
 
 
 Reference to unused volumes. This is used internally, and should not be modified manually.
 


@@ -610,15 +797,15 @@ Reference to unused volumes. This is used internally, and should not be modified
 
 Resume the container.
 
 
 Resume the container.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 

-*pct rollback* `<vmid> <snapname>`
+*pct rollback* `<vmid> <snapname>` `[OPTIONS]`

 
 Rollback LXC state to specified snapshot.
 
 
 Rollback LXC state to specified snapshot.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -626,15 +813,19 @@ The (unique) ID of the VM.
 
 The name of the snapshot.
 
 
 The name of the snapshot.
 

+`--start` `<boolean>` ('default =' `0`)::
+
+Whether the container should get started after rolling back successfully
+

 *pct set* `<vmid>` `[OPTIONS]`
 
 Set container options.
 
 *pct set* `<vmid>` `[OPTIONS]`
 
 Set container options.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 

-`--arch` `<amd64 | arm64 | armhf | i386>` ('default =' `amd64`)::
+`--arch` `<amd64 | arm64 | armhf | i386 | riscv32 | riscv64>` ('default =' `amd64`)::

 
 OS architecture type.
 
 
 OS architecture type.
 


@@ -646,21 +837,23 @@ Console mode. By default, the console command tries to open a connection to one
 
 Attach a console device (/dev/console) to the container.
 
 
 Attach a console device (/dev/console) to the container.
 

-`--cores` `<integer> (1 - 128)` ::
+`--cores` `<integer> (1 - 8192)` ::

 
 The number of cores assigned to the container. A container can use all available cores by default.
 
 
 The number of cores assigned to the container. A container can use all available cores by default.
 

-`--cpulimit` `<number> (0 - 128)` ('default =' `0`)::
+`--cpulimit` `<number> (0 - 8192)` ('default =' `0`)::

 
 Limit of CPU usage.
 +
 NOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit.
 
 
 Limit of CPU usage.
 +
 NOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit.
 

-`--cpuunits` `<integer> (0 - 500000)` ('default =' `1024`)::
+`--cpuunits` `<integer> (0 - 500000)` ('default =' `cgroup v1: 1024, cgroup v2: 100`)::

 
 

-CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to the weights of all the other running VMs.
-+
-NOTE: You can disable fair-scheduler configuration by setting this to 0.
+CPU weight for a container, will be clamped to [1, 10000] in cgroup v2.
+
+`--debug` `<boolean>` ('default =' `0`)::
+
+Try to be more verbose. For now this only enables debug log-level on start.

 
 `--delete` `<string>` ::
 
 
 `--delete` `<string>` ::
 


@@ -668,45 +861,53 @@ A list of settings you want to delete.
 
 `--description` `<string>` ::
 
 
 `--description` `<string>` ::
 

-Container description. Only used on the configuration web interface.
+Description for the Container. Shown in the web-interface CT's summary. This is saved as comment inside the configuration file.
+
+`--dev[n]` `[[path=]<Path>] [,gid=<integer>] [,mode=<Octal access mode>] [,uid=<integer>]` ::
+
+Device to pass through to the container

 
 `--digest` `<string>` ::
 
 Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
 
 
 `--digest` `<string>` ::
 
 Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
 

-`--features` `[fuse=<1|0>] [,keyctl=<1|0>] [,mount=<fstype;fstype;...>] [,nesting=<1|0>]` ::
+`--features` `[force_rw_sys=<1|0>] [,fuse=<1|0>] [,keyctl=<1|0>] [,mknod=<1|0>] [,mount=<fstype;fstype;...>] [,nesting=<1|0>]` ::

 
 Allow containers access to advanced features.
 
 
 Allow containers access to advanced features.
 

+`--hookscript` `<string>` ::
+
+Script that will be exectued during various steps in the containers lifetime.
+

 `--hostname` `<string>` ::
 
 Set a host name for the container.
 
 `--hostname` `<string>` ::
 
 Set a host name for the container.
 

-`--lock` `<backup | disk | migrate | mounted | rollback | snapshot | snapshot-delete>` ::
+`--lock` `<backup | create | destroyed | disk | fstrim | migrate | mounted | rollback | snapshot | snapshot-delete>` ::

 
 

-Lock/unlock the VM.
+Lock/unlock the container.

 
 `--memory` `<integer> (16 - N)` ('default =' `512`)::
 
 
 `--memory` `<integer> (16 - N)` ('default =' `512`)::
 

-Amount of RAM for the VM in MB.
+Amount of RAM for the container in MB.

 
 

-`--mp[n]` `[volume=]<volume> ,mp=<Path> [,acl=<1|0>] [,backup=<1|0>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::
+`--mp[n]` `[volume=]<volume> ,mp=<Path> [,acl=<1|0>] [,backup=<1|0>] [,mountoptions=<opt[;opt...]>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::

 
 

-Use volume as container mount point.
+Use volume as container mount point. Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume.

 
 `--nameserver` `<string>` ::
 
 Sets DNS server IP address for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
 
 
 `--nameserver` `<string>` ::
 
 Sets DNS server IP address for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
 

-`--net[n]` `name=<string> [,bridge=<bridge>] [,firewall=<1|0>] [,gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,hwaddr=<XX:XX:XX:XX:XX:XX>] [,ip=<(IPv4/CIDR|dhcp|manual)>] [,ip6=<(IPv6/CIDR|auto|dhcp|manual)>] [,mtu=<integer>] [,rate=<mbps>] [,tag=<integer>] [,trunks=<vlanid[;vlanid...]>] [,type=<veth>]` ::
+`--net[n]` `name=<string> [,bridge=<bridge>] [,firewall=<1|0>] [,gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,hwaddr=<XX:XX:XX:XX:XX:XX>] [,ip=<(IPv4/CIDR|dhcp|manual)>] [,ip6=<(IPv6/CIDR|auto|dhcp|manual)>] [,link_down=<1|0>] [,mtu=<integer>] [,rate=<mbps>] [,tag=<integer>] [,trunks=<vlanid[;vlanid...]>] [,type=<veth>]` ::

 
 Specifies network interfaces for the container.
 
 `--onboot` `<boolean>` ('default =' `0`)::
 
 
 Specifies network interfaces for the container.
 
 `--onboot` `<boolean>` ('default =' `0`)::
 

-Specifies whether a VM will be started during system bootup.
+Specifies whether a container will be started during system bootup.

 
 

-`--ostype` `<alpine | archlinux | centos | debian | fedora | gentoo | opensuse | ubuntu | unmanaged>` ::
+`--ostype` `<alpine | archlinux | centos | debian | devuan | fedora | gentoo | nixos | opensuse | ubuntu | unmanaged>` ::

 
 OS type. This is used to setup configuration inside the container, and corresponds to lxc setup scripts in /usr/share/lxc/config/<ostype>.common.conf. Value 'unmanaged' can be used to skip and OS specific setup.
 
 
 OS type. This is used to setup configuration inside the container, and corresponds to lxc setup scripts in /usr/share/lxc/config/<ostype>.common.conf. Value 'unmanaged' can be used to skip and OS specific setup.
 


@@ -714,7 +915,11 @@ OS type. This is used to setup configuration inside the container, and correspon
 
 Sets the protection flag of the container. This will prevent the CT or CT's disk remove/update operation.
 
 
 Sets the protection flag of the container. This will prevent the CT or CT's disk remove/update operation.
 

-`--rootfs` `[volume=]<volume> [,acl=<1|0>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::
+`--revert` `<string>` ::
+
+Revert a pending change.
+
+`--rootfs` `[volume=]<volume> [,acl=<1|0>] [,mountoptions=<opt[;opt...]>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::

 
 Use volume as container root.
 
 
 Use volume as container root.
 


@@ -728,12 +933,20 @@ Startup and shutdown behavior. Order is a non-negative number defining the gener
 
 `--swap` `<integer> (0 - N)` ('default =' `512`)::
 
 
 `--swap` `<integer> (0 - N)` ('default =' `512`)::
 

-Amount of SWAP for the VM in MB.
+Amount of SWAP for the container in MB.
+
+`--tags` `<string>` ::
+
+Tags of the Container. This is only meta information.

 
 `--template` `<boolean>` ('default =' `0`)::
 
 Enable/disable Template.
 
 
 `--template` `<boolean>` ('default =' `0`)::
 
 Enable/disable Template.
 

+`--timezone` `<string>` ::
+
+Time zone to use in the container. If option isn't set, then nothing will be done. Can be set to 'host' to match the host time zone, or an arbitrary time zone option from /usr/share/zoneinfo/zone.tab
+

 `--tty` `<integer> (0 - 6)` ('default =' `2`)::
 
 Specify the number of tty available to the container
 `--tty` `<integer> (0 - 6)` ('default =' `2`)::
 
 Specify the number of tty available to the container


@@ -742,7 +955,7 @@ Specify the number of tty available to the container
 
 Makes the container run as unprivileged user. (Should not be modified manually.)
 
 
 Makes the container run as unprivileged user. (Should not be modified manually.)
 

-`--unused[n]` `<string>` ::
+`--unused[n]` `[volume=]<volume>` ::

 
 Reference to unused volumes. This is used internally, and should not be modified manually.
 
 
 Reference to unused volumes. This is used internally, and should not be modified manually.
 


@@ -751,7 +964,7 @@ Reference to unused volumes. This is used internally, and should not be modified
 Shutdown the container. This will trigger a clean shutdown of the
 container, see lxc-stop(1) for details.
 
 Shutdown the container. This will trigger a clean shutdown of the
 container, see lxc-stop(1) for details.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -767,7 +980,7 @@ Wait maximal timeout seconds.
 
 Snapshot a container.
 
 
 Snapshot a container.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -783,10 +996,14 @@ A textual description or comment.
 
 Start the container.
 
 
 Start the container.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 

+`--debug` `<boolean>` ('default =' `0`)::
+
+If set, enables very verbose debug log-level on start.
+

 `--skiplock` `<boolean>` ::
 
 Ignore locks - only root is allowed to use this option.
 `--skiplock` `<boolean>` ::
 
 Ignore locks - only root is allowed to use this option.


@@ -795,7 +1012,7 @@ Ignore locks - only root is allowed to use this option.
 
 Show CT status.
 
 
 Show CT status.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -808,19 +1025,23 @@ Verbose output format
 Stop the container. This will abruptly stop all processes running in the
 container.
 
 Stop the container. This will abruptly stop all processes running in the
 container.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 

+`--overrule-shutdown` `<boolean>` ('default =' `0`)::
+
+Try to abort active 'vzshutdown' tasks before stopping.
+

 `--skiplock` `<boolean>` ::
 
 Ignore locks - only root is allowed to use this option.
 
 *pct suspend* `<vmid>`
 
 `--skiplock` `<boolean>` ::
 
 Ignore locks - only root is allowed to use this option.
 
 *pct suspend* `<vmid>`
 

-Suspend the container.
+Suspend the container. This is experimental.

 
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -828,7 +1049,7 @@ The (unique) ID of the VM.
 
 Create a Template.
 
 
 Create a Template.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -836,7 +1057,7 @@ The (unique) ID of the VM.
 
 Unlock the VM.
 
 
 Unlock the VM.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.
 


@@ -844,7 +1065,7 @@ The (unique) ID of the VM.
 
 Unmount the container's filesystem.
 
 
 Unmount the container's filesystem.
 

-`<vmid>`: `<integer> (1 - N)` ::
+`<vmid>`: `<integer> (100 - 999999999)` ::

 
 The (unique) ID of the VM.
 
 
 The (unique) ID of the VM.