*pct* `<COMMAND> [ARGS] [OPTIONS]`
-*pct config* `<vmid>`
+*pct clone* `<vmid> <newid>` `[OPTIONS]`
+
+Create a container clone/copy
+
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
+
+`<newid>`: `<integer> (1 - N)` ::
+
+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.
+
+`--full` `<boolean>` ::
+
+Create a full copy of all disks. This is always done when you clone a normal CT. For CT templates, we try to create a linked clone by default.
+
+`--hostname` `<string>` ::
+
+Set a hostname for the new CT.
+
+`--pool` `<string>` ::
+
+Add the new CT to the specified pool.
+
+`--snapname` `<string>` ::
+
+The name of the snapshot.
+
+`--storage` `<string>` ::
+
+Target storage for full clone.
+
+`--target` `<string>` ::
+
+Target node. Only allowed if the original VM is on shared storage.
+
+*pct config* `<vmid>` `[OPTIONS]`
Get container configuration.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
+`--current` `<boolean>` ('default =' `0`)::
+Get current values (instead of pending values).
+`--snapshot` `<string>` ::
-*pct console* `<vmid>`
+Fetch config values from given snapshot.
+
+*pct console* `<vmid>` `[OPTIONS]`
Launch a console for the specified container.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
+`--escape` `\^?[a-z]` ('default =' `^a`)::
+
+Escape sequence prefix. For example to use <Ctrl+b q> as the escape sequence pass '^b'.
+*pct cpusets*
+Print the list of assigned CPU sets.
*pct create* `<vmid> <ostemplate>` `[OPTIONS]`
Create or restore a container.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
-`<ostemplate>` `string` ::
+`<ostemplate>`: `<string>` ::
The OS template or backup file.
-`-arch` `(amd64 | i386)` (default=`amd64`)::
+`--arch` `<amd64 | arm64 | armhf | i386>` ('default =' `amd64`)::
OS architecture type.
-`-cmode` `(console | shell | tty)` (default=`tty`)::
+`--bwlimit` `<number> (0 - N)` ('default =' `restore limit from datacenter or storage config`)::
+
+Override I/O bandwidth limit (in KiB/s).
-Console mode. By default, the console command tries to open a connection to
-one of the available tty devices. By setting cmode to 'console' it tries to
-attach to /dev/console instead. If you set cmode to 'shell', it simply
-invokes a shell inside the container (no login).
+`--cmode` `<console | shell | tty>` ('default =' `tty`)::
-`-console` `boolean` (default=`1`)::
+Console mode. By default, the console command tries to open a connection to one of the available tty devices. By setting cmode to 'console' it tries to attach to /dev/console instead. If you set cmode to 'shell', it simply invokes a shell inside the container (no login).
+
+`--console` `<boolean>` ('default =' `1`)::
Attach a console device (/dev/console) to the container.
-`-cpulimit` `number (0 - 128)` (default=`0`)::
+`--cores` `<integer> (1 - 8192)` ::
+
+The number of cores assigned to the container. A container can use all available cores by default.
-Limit of CPU usage. Note if the computer has 2 CPUs, it has total of '2'
-CPU time. Value '0' indicates no CPU limit.
+`--cpulimit` `<number> (0 - 8192)` ('default =' `0`)::
-`-cpuunits` `integer (0 - 500000)` (default=`1024`)::
+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.
-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
-weights of all the other running VMs.
+`--cpuunits` `<integer> (0 - 500000)` ('default =' `1024`)::
+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.
-`-description` `string` ::
+`--debug` `<boolean>` ('default =' `0`)::
+
+Try to be more verbose. For now this only enables debug log-level on start.
+
+`--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.
-`-force` `boolean` ::
+`--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.
+
+`--force` `<boolean>` ::
Allow to overwrite existing container.
-`-hostname` `string` ::
+`--hookscript` `<string>` ::
+
+Script that will be exectued during various steps in the containers lifetime.
+
+`--hostname` `<string>` ::
Set a host name for the container.
-`-ignore-unpack-errors` `boolean` ::
+`--ignore-unpack-errors` `<boolean>` ::
Ignore errors when extracting the template.
-`-lock` `(backup | migrate | rollback | snapshot)` ::
+`--lock` `<backup | create | destroyed | disk | fstrim | migrate | mounted | rollback | snapshot | snapshot-delete>` ::
Lock/unlock the VM.
-`-memory` `integer (16 - N)` (default=`512`)::
+`--memory` `<integer> (16 - N)` ('default =' `512`)::
Amount of RAM for the VM in MB.
-`-mp[n]` `[volume=]<volume> [,backup=<[1|0]>] [,mp=<Path>] [,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 (experimental feature).
+Use volume as container mount point. Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume.
-`-nameserver` `string` ::
+`--nameserver` `<string>` ::
-Sets DNS server IP address for a container. Create will automatically use
-the setting from the host if you neither set searchdomain or nameserver.
+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=<vmbr<Number>>] [,firewall=<[1|0]>] [,gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,hwaddr=<MAC>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>] [,mtu=<Number>] [,tag=<VlanNo>]` ::
+`--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>]` ::
Specifies network interfaces for the container.
-`-onboot` `boolean` (default=`0`)::
+`--onboot` `<boolean>` ('default =' `0`)::
Specifies whether a VM will be started during system bootup.
-`-ostype` `(archlinux | centos | debian | fedora | opensuse | ubuntu)` ::
+`--ostype` `<alpine | archlinux | centos | debian | devuan | fedora | gentoo | opensuse | ubuntu | unmanaged>` ::
-OS type. Corresponds to lxc setup scripts in
-/usr/share/lxc/config/<ostype>.common.conf.
+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.
-`-password` `string` ::
+`--password` `<password>` ::
Sets root password inside container.
-`-pool` `string` ::
+`--pool` `<string>` ::
Add the VM to the specified pool.
-`-protection` `boolean` (default=`0`)::
+`--protection` `<boolean>` ('default =' `0`)::
-Sets the protection flag of the container. This will prevent the remove
-operation. 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.
-`-restore` `boolean` ::
+`--restore` `<boolean>` ::
Mark this as restore task.
-`-rootfs` `[volume=]<volume> [,backup=<[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.
-`-searchdomain` `string` ::
+`--searchdomain` `<string>` ::
+
+Sets DNS search domains for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
+
+`--ssh-public-keys` `<filepath>` ::
-Sets DNS search domains for a container. Create will automatically use the
-setting from the host if you neither set searchdomain or nameserver.
+Setup public SSH keys (one key per line, OpenSSH format).
-`-startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
+`--start` `<boolean>` ('default =' `0`)::
-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.
+Start the CT after its creation finished successfully.
-`-storage` `string` (default=`local`)::
+`--startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
+
+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`)::
Default Storage.
-`-swap` `integer (0 - N)` (default=`512`)::
+`--swap` `<integer> (0 - N)` ('default =' `512`)::
Amount of SWAP for the VM in MB.
-`-template` `boolean` (default=`0`)::
+`--tags` `<string>` ::
+
+Tags of the Container. This is only meta information.
+
+`--template` `<boolean>` ('default =' `0`)::
Enable/disable Template.
-`-tty` `integer (0 - 6)` (default=`2`)::
+`--timezone` `<string>` ::
-Specify the number of tty available to the container
+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
-`-unprivileged` `boolean` (default=`0`)::
+`--tty` `<integer> (0 - 6)` ('default =' `2`)::
+
+Specify the number of tty available to the container
-Makes the container run as unprivileged user. (Should not be modified
-manually.)
+`--unique` `<boolean>` ::
-`-unused[n]` `string` ::
+Assign a unique random ethernet address.
++
+NOTE: Requires option(s): `restore`
-Reference to unused volumes.
+`--unprivileged` `<boolean>` ('default =' `0`)::
+Makes the container run as unprivileged user. (Should not be modified manually.)
+`--unused[n]` `[volume=]<volume>` ::
+Reference to unused volumes. This is used internally, and should not be modified manually.
*pct delsnapshot* `<vmid> <snapname>` `[OPTIONS]`
Delete a LXC snapshot.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
-`<snapname>` `string` ::
+`<snapname>`: `<string>` ::
The name of the snapshot.
-`-force` `boolean` ::
+`--force` `<boolean>` ::
For removal from config file, even if removing disk snapshots fails.
+*pct destroy* `<vmid>` `[OPTIONS]`
+Destroy the container (also delete all uses files).
+`<vmid>`: `<integer> (1 - N)` ::
-*pct destroy* `<vmid>`
+The (unique) ID of the VM.
-Destroy the container (also delete all uses files).
+`--destroy-unreferenced-disks` `<boolean>` ::
-`<vmid>` `integer (1 - N)` ::
+If set, destroy additionally all disks with the VMID from all enabled storages which are not referenced in the config.
-The (unique) ID of the VM.
+`--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 enter* `<vmid>`
+*pct df* `<vmid>`
-Launch a shell for the specified container.
+Get the container's current disk usage.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
+*pct enter* `<vmid>`
+
+Launch a shell for the specified container.
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
*pct exec* `<vmid> [<extra-args>]`
Launch a command inside the specified container.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
-`<extra-args>` `array` ::
+`<extra-args>`: `<array>` ::
Extra arguments as array
-
-
*pct fsck* `<vmid>` `[OPTIONS]`
Run a filesystem check (fsck) on a container volume.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
-`-device` `(mp0 | mp1 | mp2 | mp3 | mp4 | mp5 | mp6 | mp7 | mp8 | mp9 | rootfs)` ::
+`--device` `<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>` ::
A volume on which to run the filesystem check
-`-force` `boolean` (default=`0`)::
+`--force` `<boolean>` ('default =' `0`)::
Force checking, even if the filesystem seems clean
+*pct fstrim* `<vmid>` `[OPTIONS]`
+Run fstrim on a chosen CT and its mountpoints.
+`<vmid>`: `<integer> (1 - N)` ::
-*pct help* `[<cmd>]` `[OPTIONS]`
+The (unique) ID of the VM.
-Get help about specified command.
+`--ignore-mountpoints` `<boolean>` ::
-`<cmd>` `string` ::
+Skip all mountpoints, only do fstrim on the container root.
-Command name
+*pct help* `[OPTIONS]`
-`-verbose` `boolean` ::
+Get help about specified command.
-Verbose output format.
+`--extra-args` `<array>` ::
+Shows help for a specific command
+`--verbose` `<boolean>` ::
+Verbose output format.
*pct list*
LXC container index (per node).
-
-
-
*pct listsnapshot* `<vmid>`
List all snapshots.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
-
-
-
*pct migrate* `<vmid> <target>` `[OPTIONS]`
Migrate the container to another node. Creates a new migration task.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
-`<target>` `string` ::
+`<target>`: `<string>` ::
Target node.
-`-online` `boolean` ::
+`--bwlimit` `<number> (0 - N)` ('default =' `migrate limit from datacenter or storage config`)::
+
+Override I/O bandwidth limit (in KiB/s).
+
+`--online` `<boolean>` ::
Use online/live migration.
+`--restart` `<boolean>` ::
+Use restart migration
-*pct resize* `<vmid> <disk> <size>` `[OPTIONS]`
+`--timeout` `<integer>` ('default =' `180`)::
+
+Timeout in seconds for shutdown for restart migration
+
+*pct mount* `<vmid>`
-Resize a container mountpoint.
+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.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
-`<disk>` `(mp0 | mp1 | mp2 | mp3 | mp4 | mp5 | mp6 | mp7 | mp8 | mp9 | rootfs)` ::
+*pct move-volume* `<vmid> <volume> [<storage>] [<target-vmid>] [<target-volume>]` `[OPTIONS]`
-The disk you want to resize.
+Move a rootfs-/mp-volume to a different storage or to a different
+container.
+
+`<vmid>`: `<integer> (1 - N)` ::
+
+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 | 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.
+
+`<storage>`: `<string>` ::
+
+Target Storage.
+
+`<target-vmid>`: `<integer> (1 - N)` ::
+
+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>` ::
+
+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> (1 - N)` ::
+
+The (unique) ID of the VM.
+
+*pct pull* `<vmid> <path> <destination>` `[OPTIONS]`
+
+Copy a file from the container to the local system.
+
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
+
+`<path>`: `<string>` ::
+
+Path to a file inside the container to pull.
+
+`<destination>`: `<string>` ::
+
+Destination
+
+`--group` `<string>` ::
+
+Owner group name or id.
-`<size>` `\+?\d+(\.\d+)?[KMGT]?` ::
+`--perms` `<string>` ::
-The new size. With the '+' sign the value is added to the actual size of
-the volume and without it, the value is taken as an absolute one. Shrinking
-disk size is not supported.
+File permissions to use (octal by default, prefix with '0x' for hexadecimal).
+
+`--user` `<string>` ::
+
+Owner user name or id.
+
+*pct push* `<vmid> <file> <destination>` `[OPTIONS]`
+
+Copy a local file to the container.
+
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
-`-digest` `string` ::
+`<file>`: `<string>` ::
-Prevent changes if current configuration file has different SHA1 digest.
-This can be used to prevent concurrent modifications.
+Path to a local file.
+
+`<destination>`: `<string>` ::
+
+Destination inside the container to write to.
+
+`--group` `<string>` ::
+
+Owner group name or id. When using a name it must exist inside the container.
+
+`--perms` `<string>` ::
+
+File permissions to use (octal by default, prefix with '0x' for hexadecimal).
+
+`--user` `<string>` ::
+
+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> (1 - N)` ::
+
+The (unique) ID of the VM.
+`--timeout` `<integer> (0 - N)` ::
+Wait maximal timeout seconds for the shutdown.
+
+*pct rescan* `[OPTIONS]`
+
+Rescan all storages and update disk sizes and unused disk images.
+
+`--dryrun` `<boolean>` ('default =' `0`)::
+
+Do not actually write changes out to conifg.
+
+`--vmid` `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
+
+*pct resize* `<vmid> <disk> <size>` `[OPTIONS]`
+
+Resize a container mount point.
+
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
+
+`<disk>`: `<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>` ::
+
+The disk you want to resize.
+
+`<size>`: `\+?\d+(\.\d+)?[KMGT]?` ::
+
+The new size. With the '+' sign the value is added to the actual size of the volume and without it, the value is taken as an absolute one. Shrinking disk size is not supported.
+
+`--digest` `<string>` ::
+
+Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
*pct restore* `<vmid> <ostemplate>` `[OPTIONS]`
Create or restore a container.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
-`<ostemplate>` `string` ::
+`<ostemplate>`: `<string>` ::
The OS template or backup file.
-`-arch` `(amd64 | i386)` (default=`amd64`)::
+`--arch` `<amd64 | arm64 | armhf | i386>` ('default =' `amd64`)::
OS architecture type.
-`-cmode` `(console | shell | tty)` (default=`tty`)::
+`--bwlimit` `<number> (0 - N)` ('default =' `restore limit from datacenter or storage config`)::
-Console mode. By default, the console command tries to open a connection to
-one of the available tty devices. By setting cmode to 'console' it tries to
-attach to /dev/console instead. If you set cmode to 'shell', it simply
-invokes a shell inside the container (no login).
+Override I/O bandwidth limit (in KiB/s).
-`-console` `boolean` (default=`1`)::
+`--cmode` `<console | shell | tty>` ('default =' `tty`)::
+
+Console mode. By default, the console command tries to open a connection to one of the available tty devices. By setting cmode to 'console' it tries to attach to /dev/console instead. If you set cmode to 'shell', it simply invokes a shell inside the container (no login).
+
+`--console` `<boolean>` ('default =' `1`)::
Attach a console device (/dev/console) to the container.
-`-cpulimit` `number (0 - 128)` (default=`0`)::
+`--cores` `<integer> (1 - 8192)` ::
+
+The number of cores assigned to the container. A container can use all available cores by default.
-Limit of CPU usage. Note if the computer has 2 CPUs, it has total of '2'
-CPU time. Value '0' indicates no CPU limit.
+`--cpulimit` `<number> (0 - 8192)` ('default =' `0`)::
-`-cpuunits` `integer (0 - 500000)` (default=`1024`)::
+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.
-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
-weights of all the other running VMs.
+`--cpuunits` `<integer> (0 - 500000)` ('default =' `1024`)::
+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.
-`-description` `string` ::
+`--debug` `<boolean>` ('default =' `0`)::
+
+Try to be more verbose. For now this only enables debug log-level on start.
+
+`--description` `<string>` ::
+
+Description for the Container. Shown in the web-interface CT's summary. This is saved as comment inside the configuration file.
-Container description. Only used on the configuration web interface.
+`--features` `[force_rw_sys=<1|0>] [,fuse=<1|0>] [,keyctl=<1|0>] [,mknod=<1|0>] [,mount=<fstype;fstype;...>] [,nesting=<1|0>]` ::
-`-force` `boolean` ::
+Allow containers access to advanced features.
+
+`--force` `<boolean>` ::
Allow to overwrite existing container.
-`-hostname` `string` ::
+`--hookscript` `<string>` ::
+
+Script that will be exectued during various steps in the containers lifetime.
+
+`--hostname` `<string>` ::
Set a host name for the container.
-`-ignore-unpack-errors` `boolean` ::
+`--ignore-unpack-errors` `<boolean>` ::
Ignore errors when extracting the template.
-`-lock` `(backup | migrate | rollback | snapshot)` ::
+`--lock` `<backup | create | destroyed | disk | fstrim | migrate | mounted | rollback | snapshot | snapshot-delete>` ::
Lock/unlock the VM.
-`-memory` `integer (16 - N)` (default=`512`)::
+`--memory` `<integer> (16 - N)` ('default =' `512`)::
Amount of RAM for the VM in MB.
-`-mp[n]` `[volume=]<volume> [,backup=<[1|0]>] [,mp=<Path>] [,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 (experimental feature).
+Use volume as container mount point. Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume.
-`-nameserver` `string` ::
+`--nameserver` `<string>` ::
-Sets DNS server IP address for a container. Create will automatically use
-the setting from the host if you neither set searchdomain or nameserver.
+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=<vmbr<Number>>] [,firewall=<[1|0]>] [,gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,hwaddr=<MAC>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>] [,mtu=<Number>] [,tag=<VlanNo>]` ::
+`--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>]` ::
Specifies network interfaces for the container.
-`-onboot` `boolean` (default=`0`)::
+`--onboot` `<boolean>` ('default =' `0`)::
Specifies whether a VM will be started during system bootup.
-`-ostype` `(archlinux | centos | debian | fedora | opensuse | ubuntu)` ::
+`--ostype` `<alpine | archlinux | centos | debian | devuan | fedora | gentoo | opensuse | ubuntu | unmanaged>` ::
-OS type. Corresponds to lxc setup scripts in
-/usr/share/lxc/config/<ostype>.common.conf.
+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.
-`-password` `string` ::
+`--password` `<password>` ::
Sets root password inside container.
-`-pool` `string` ::
+`--pool` `<string>` ::
Add the VM to the specified pool.
-`-protection` `boolean` (default=`0`)::
+`--protection` `<boolean>` ('default =' `0`)::
-Sets the protection flag of the container. This will prevent the remove
-operation. 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> [,backup=<[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.
-`-searchdomain` `string` ::
+`--searchdomain` `<string>` ::
+
+Sets DNS search domains for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
+
+`--ssh-public-keys` `<filepath>` ::
+
+Setup public SSH keys (one key per line, OpenSSH format).
+
+`--start` `<boolean>` ('default =' `0`)::
-Sets DNS search domains for a container. Create will automatically use the
-setting from the host if you neither set searchdomain or nameserver.
+Start the CT after its creation finished successfully.
-`-startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
+`--startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
-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` `<string>` ('default =' `local`)::
Default Storage.
-`-swap` `integer (0 - N)` (default=`512`)::
+`--swap` `<integer> (0 - N)` ('default =' `512`)::
Amount of SWAP for the VM in MB.
-`-template` `boolean` (default=`0`)::
+`--tags` `<string>` ::
+
+Tags of the Container. This is only meta information.
+
+`--template` `<boolean>` ('default =' `0`)::
Enable/disable Template.
-`-tty` `integer (0 - 6)` (default=`2`)::
+`--timezone` `<string>` ::
-Specify the number of tty available to the container
+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
-`-unprivileged` `boolean` (default=`0`)::
+`--tty` `<integer> (0 - 6)` ('default =' `2`)::
-Makes the container run as unprivileged user. (Should not be modified
-manually.)
+Specify the number of tty available to the container
+
+`--unique` `<boolean>` ::
-`-unused[n]` `string` ::
+Assign a unique random ethernet address.
++
+NOTE: Requires option(s): `restore`
-Reference to unused volumes.
+`--unprivileged` `<boolean>` ('default =' `0`)::
+Makes the container run as unprivileged user. (Should not be modified manually.)
+`--unused[n]` `[volume=]<volume>` ::
+Reference to unused volumes. This is used internally, and should not be modified manually.
*pct resume* `<vmid>`
Resume the container.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
-
-
-
*pct rollback* `<vmid> <snapname>`
Rollback LXC state to specified snapshot.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
-`<snapname>` `string` ::
+`<snapname>`: `<string>` ::
The name of the snapshot.
-
-
-
*pct set* `<vmid>` `[OPTIONS]`
Set container options.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
-`-arch` `(amd64 | i386)` (default=`amd64`)::
+`--arch` `<amd64 | arm64 | armhf | i386>` ('default =' `amd64`)::
OS architecture type.
-`-cmode` `(console | shell | tty)` (default=`tty`)::
+`--cmode` `<console | shell | tty>` ('default =' `tty`)::
-Console mode. By default, the console command tries to open a connection to
-one of the available tty devices. By setting cmode to 'console' it tries to
-attach to /dev/console instead. If you set cmode to 'shell', it simply
-invokes a shell inside the container (no login).
+Console mode. By default, the console command tries to open a connection to one of the available tty devices. By setting cmode to 'console' it tries to attach to /dev/console instead. If you set cmode to 'shell', it simply invokes a shell inside the container (no login).
-`-console` `boolean` (default=`1`)::
+`--console` `<boolean>` ('default =' `1`)::
Attach a console device (/dev/console) to the container.
-`-cpulimit` `number (0 - 128)` (default=`0`)::
+`--cores` `<integer> (1 - 8192)` ::
+
+The number of cores assigned to the container. A container can use all available cores by default.
-Limit of CPU usage. Note if the computer has 2 CPUs, it has total of '2'
-CPU time. Value '0' indicates no CPU limit.
+`--cpulimit` `<number> (0 - 8192)` ('default =' `0`)::
-`-cpuunits` `integer (0 - 500000)` (default=`1024`)::
+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.
-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
-weights of all the other running VMs.
+`--cpuunits` `<integer> (0 - 500000)` ('default =' `1024`)::
+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.
-`-delete` `string` ::
+`--debug` `<boolean>` ('default =' `0`)::
+
+Try to be more verbose. For now this only enables debug log-level on start.
+
+`--delete` `<string>` ::
A list of settings you want to delete.
-`-description` `string` ::
+`--description` `<string>` ::
+
+Description for the Container. Shown in the web-interface CT's summary. This is saved as comment inside the configuration file.
+
+`--digest` `<string>` ::
-Container description. Only used on the configuration web interface.
+Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
-`-digest` `string` ::
+`--features` `[force_rw_sys=<1|0>] [,fuse=<1|0>] [,keyctl=<1|0>] [,mknod=<1|0>] [,mount=<fstype;fstype;...>] [,nesting=<1|0>]` ::
-Prevent changes if current configuration file has different SHA1 digest.
-This can be used to prevent concurrent modifications.
+Allow containers access to advanced features.
-`-hostname` `string` ::
+`--hookscript` `<string>` ::
+
+Script that will be exectued during various steps in the containers lifetime.
+
+`--hostname` `<string>` ::
Set a host name for the container.
-`-lock` `(backup | migrate | rollback | snapshot)` ::
+`--lock` `<backup | create | destroyed | disk | fstrim | migrate | mounted | rollback | snapshot | snapshot-delete>` ::
Lock/unlock the VM.
-`-memory` `integer (16 - N)` (default=`512`)::
+`--memory` `<integer> (16 - N)` ('default =' `512`)::
Amount of RAM for the VM in MB.
-`-mp[n]` `[volume=]<volume> [,backup=<[1|0]>] [,mp=<Path>] [,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 (experimental feature).
+Use volume as container mount point. Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume.
-`-nameserver` `string` ::
+`--nameserver` `<string>` ::
-Sets DNS server IP address for a container. Create will automatically use
-the setting from the host if you neither set searchdomain or nameserver.
+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=<vmbr<Number>>] [,firewall=<[1|0]>] [,gw=<GatewayIPv4>] [,gw6=<GatewayIPv6>] [,hwaddr=<MAC>] [,ip=<IPv4Format/CIDR>] [,ip6=<IPv6Format/CIDR>] [,mtu=<Number>] [,tag=<VlanNo>]` ::
+`--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>]` ::
Specifies network interfaces for the container.
-`-onboot` `boolean` (default=`0`)::
+`--onboot` `<boolean>` ('default =' `0`)::
Specifies whether a VM will be started during system bootup.
-`-ostype` `(archlinux | centos | debian | fedora | opensuse | ubuntu)` ::
+`--ostype` `<alpine | archlinux | centos | debian | devuan | fedora | gentoo | 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. Corresponds to lxc setup scripts in
-/usr/share/lxc/config/<ostype>.common.conf.
+`--protection` `<boolean>` ('default =' `0`)::
-`-protection` `boolean` (default=`0`)::
+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 remove
-operation. This will prevent the CT or CT's disk remove/update operation.
+`--revert` `<string>` ::
-`-rootfs` `[volume=]<volume> [,backup=<[1|0]>] [,size=<DiskSize>]` ::
+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.
-`-searchdomain` `string` ::
+`--searchdomain` `<string>` ::
-Sets DNS search domains for a container. Create will automatically use the
-setting from the host if you neither set searchdomain or nameserver.
+Sets DNS search domains for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
-`-startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
+`--startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
-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.
-`-swap` `integer (0 - N)` (default=`512`)::
+`--swap` `<integer> (0 - N)` ('default =' `512`)::
Amount of SWAP for the VM in MB.
-`-template` `boolean` (default=`0`)::
+`--tags` `<string>` ::
-Enable/disable Template.
+Tags of the Container. This is only meta information.
-`-tty` `integer (0 - 6)` (default=`2`)::
+`--template` `<boolean>` ('default =' `0`)::
-Specify the number of tty available to the container
+Enable/disable Template.
-`-unprivileged` `boolean` (default=`0`)::
+`--timezone` `<string>` ::
-Makes the container run as unprivileged user. (Should not be modified
-manually.)
+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
-`-unused[n]` `string` ::
+`--tty` `<integer> (0 - 6)` ('default =' `2`)::
-Reference to unused volumes.
+Specify the number of tty available to the container
+
+`--unprivileged` `<boolean>` ('default =' `0`)::
+Makes the container run as unprivileged user. (Should not be modified manually.)
+`--unused[n]` `[volume=]<volume>` ::
+Reference to unused volumes. This is used internally, and should not be modified manually.
*pct shutdown* `<vmid>` `[OPTIONS]`
-Shutdown the container.
+Shutdown the container. This will trigger a clean shutdown of the
+container, see lxc-stop(1) for details.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
-`-forceStop` `boolean` (default=`0`)::
+`--forceStop` `<boolean>` ('default =' `0`)::
Make sure the Container stops.
-`-timeout` `integer (0 - N)` (default=`60`)::
+`--timeout` `<integer> (0 - N)` ('default =' `60`)::
Wait maximal timeout seconds.
-
-
-
*pct snapshot* `<vmid> <snapname>` `[OPTIONS]`
Snapshot a container.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
-`<snapname>` `string` ::
+`<snapname>`: `<string>` ::
The name of the snapshot.
-`-description` `string` ::
+`--description` `<string>` ::
A textual description or comment.
-
-
-
-*pct start* `<vmid>`
+*pct start* `<vmid>` `[OPTIONS]`
Start the container.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
+`--debug` `<boolean>` ('default =' `0`)::
+
+If set, enables very verbose debug log-level on start.
+`--skiplock` `<boolean>` ::
-*pct stop* `<vmid>`
+Ignore locks - only root is allowed to use this option.
-Stop the container.
+*pct status* `<vmid>` `[OPTIONS]`
-`<vmid>` `integer (1 - N)` ::
+Show CT status.
+
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
+`--verbose` `<boolean>` ::
+Verbose output format
-*pct suspend* `<vmid>`
+*pct stop* `<vmid>` `[OPTIONS]`
-Suspend the container.
+Stop the container. This will abruptly stop all processes running in the
+container.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
+`--skiplock` `<boolean>` ::
+Ignore locks - only root is allowed to use this option.
+*pct suspend* `<vmid>`
-*pct template* `<vmid>`
-
-Create a Template.
+Suspend the container. This is experimental.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
+*pct template* `<vmid>`
+Create a Template.
+
+`<vmid>`: `<integer> (1 - N)` ::
+The (unique) ID of the VM.
*pct unlock* `<vmid>`
Unlock the VM.
-`<vmid>` `integer (1 - N)` ::
+`<vmid>`: `<integer> (1 - N)` ::
The (unique) ID of the VM.
+*pct unmount* `<vmid>`
+Unmount the container's filesystem.
+
+`<vmid>`: `<integer> (1 - N)` ::
+
+The (unique) ID of the VM.
projects / pve-docs.git / blobdiff