]> git.proxmox.com Git - pve-docs.git/blame - pct.1-synopsis.adoc
firewall: add documentation for proxmox-firewall
[pve-docs.git] / pct.1-synopsis.adoc
CommitLineData
1f554f76
DM
1*pct* `<COMMAND> [ARGS] [OPTIONS]`
2
27a7acb2 3*pct clone* `<vmid> <newid>` `[OPTIONS]`
9b3e4991
DM
4
5Create a container clone/copy
6
8dd66e12 7`<vmid>`: `<integer> (100 - 999999999)` ::
9b3e4991
DM
8
9The (unique) ID of the VM.
10
8dd66e12 11`<newid>`: `<integer> (100 - 999999999)` ::
9b3e4991
DM
12
13VMID for the clone.
14
95895385
TL
15`--bwlimit` `<number> (0 - N)` ('default =' `clone limit from datacenter or storage config`)::
16
17Override I/O bandwidth limit (in KiB/s).
18
2489d6df 19`--description` `<string>` ::
9b3e4991
DM
20
21Description for the new CT.
22
27a7acb2 23`--full` `<boolean>` ::
9b3e4991 24
27a7acb2 25Create 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.
9b3e4991 26
2489d6df 27`--hostname` `<string>` ::
9b3e4991
DM
28
29Set a hostname for the new CT.
30
2489d6df 31`--pool` `<string>` ::
9b3e4991
DM
32
33Add the new CT to the specified pool.
34
2489d6df 35`--snapname` `<string>` ::
9b3e4991
DM
36
37The name of the snapshot.
38
907e4bc3 39`--storage` `<storage ID>` ::
9b3e4991
DM
40
41Target storage for full clone.
27a7acb2
DM
42
43`--target` `<string>` ::
44
45Target node. Only allowed if the original VM is on shared storage.
9b3e4991 46
5f26e15b 47*pct config* `<vmid>` `[OPTIONS]`
1f554f76
DM
48
49Get container configuration.
50
8dd66e12 51`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
52
53The (unique) ID of the VM.
54
1c532546
TL
55`--current` `<boolean>` ('default =' `0`)::
56
57Get current values (instead of pending values).
58
5f26e15b
TL
59`--snapshot` `<string>` ::
60
61Fetch config values from given snapshot.
62
4d47f125 63*pct console* `<vmid>` `[OPTIONS]`
1f554f76
DM
64
65Launch a console for the specified container.
66
8dd66e12 67`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
68
69The (unique) ID of the VM.
70
4d47f125
TL
71`--escape` `\^?[a-z]` ('default =' `^a`)::
72
73Escape sequence prefix. For example to use <Ctrl+b q> as the escape sequence pass '^b'.
74
de0983cb
DM
75*pct cpusets*
76
77Print the list of assigned CPU sets.
78
1f554f76
DM
79*pct create* `<vmid> <ostemplate>` `[OPTIONS]`
80
81Create or restore a container.
82
8dd66e12 83`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
84
85The (unique) ID of the VM.
86
013dc89f 87`<ostemplate>`: `<string>` ::
1f554f76
DM
88
89The OS template or backup file.
90
9d2e98ed 91`--arch` `<amd64 | arm64 | armhf | i386 | riscv32 | riscv64>` ('default =' `amd64`)::
1f554f76
DM
92
93OS architecture type.
94
95895385 95`--bwlimit` `<number> (0 - N)` ('default =' `restore limit from datacenter or storage config`)::
27a7acb2 96
95895385 97Override I/O bandwidth limit (in KiB/s).
27a7acb2 98
2489d6df 99`--cmode` `<console | shell | tty>` ('default =' `tty`)::
1f554f76 100
c2993fe5 101Console 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).
1f554f76 102
2489d6df 103`--console` `<boolean>` ('default =' `1`)::
1f554f76
DM
104
105Attach a console device (/dev/console) to the container.
106
4772952b 107`--cores` `<integer> (1 - 8192)` ::
de0983cb
DM
108
109The number of cores assigned to the container. A container can use all available cores by default.
110
4772952b 111`--cpulimit` `<number> (0 - 8192)` ('default =' `0`)::
1f554f76 112
9b3e4991
DM
113Limit of CPU usage.
114+
c2993fe5 115NOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit.
1f554f76 116
4e7f60c2 117`--cpuunits` `<integer> (0 - 500000)` ('default =' `cgroup v1: 1024, cgroup v2: 100`)::
1f554f76 118
4e7f60c2 119CPU weight for a container, will be clamped to [1, 10000] in cgroup v2.
1f554f76 120
739d4d64
TL
121`--debug` `<boolean>` ('default =' `0`)::
122
123Try to be more verbose. For now this only enables debug log-level on start.
124
2489d6df 125`--description` `<string>` ::
1f554f76 126
8f4d9c87 127Description for the Container. Shown in the web-interface CT's summary. This is saved as comment inside the configuration file.
1f554f76 128
fa22697b
TL
129`--dev[n]` `[[path=]<Path>] [,gid=<integer>] [,mode=<Octal access mode>] [,uid=<integer>]` ::
130
131Device to pass through to the container
132
c5aa7e14 133`--features` `[force_rw_sys=<1|0>] [,fuse=<1|0>] [,keyctl=<1|0>] [,mknod=<1|0>] [,mount=<fstype;fstype;...>] [,nesting=<1|0>]` ::
4d47f125
TL
134
135Allow containers access to advanced features.
136
2489d6df 137`--force` `<boolean>` ::
1f554f76
DM
138
139Allow to overwrite existing container.
140
5f26e15b
TL
141`--hookscript` `<string>` ::
142
143Script that will be exectued during various steps in the containers lifetime.
144
2489d6df 145`--hostname` `<string>` ::
1f554f76
DM
146
147Set a host name for the container.
148
2489d6df 149`--ignore-unpack-errors` `<boolean>` ::
1f554f76
DM
150
151Ignore errors when extracting the template.
152
1c532546 153`--lock` `<backup | create | destroyed | disk | fstrim | migrate | mounted | rollback | snapshot | snapshot-delete>` ::
1f554f76 154
4e7f60c2 155Lock/unlock the container.
1f554f76 156
2489d6df 157`--memory` `<integer> (16 - N)` ('default =' `512`)::
1f554f76 158
4e7f60c2 159Amount of RAM for the container in MB.
1f554f76 160
7cbed89a 161`--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>]` ::
1f554f76 162
d2656385 163Use volume as container mount point. Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume.
1f554f76 164
2489d6df 165`--nameserver` `<string>` ::
1f554f76 166
c2993fe5 167Sets DNS server IP address for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
1f554f76 168
9d2e98ed 169`--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>]` ::
1f554f76
DM
170
171Specifies network interfaces for the container.
172
2489d6df 173`--onboot` `<boolean>` ('default =' `0`)::
1f554f76 174
4e7f60c2 175Specifies whether a container will be started during system bootup.
1f554f76 176
7af2edf9 177`--ostype` `<alpine | archlinux | centos | debian | devuan | fedora | gentoo | nixos | opensuse | ubuntu | unmanaged>` ::
1f554f76 178
c2993fe5 179OS 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.
1f554f76 180
5da3d723 181`--password` `<password>` ::
1f554f76
DM
182
183Sets root password inside container.
184
2489d6df 185`--pool` `<string>` ::
1f554f76
DM
186
187Add the VM to the specified pool.
188
2489d6df 189`--protection` `<boolean>` ('default =' `0`)::
1f554f76 190
c2993fe5 191Sets the protection flag of the container. This will prevent the CT or CT's disk remove/update operation.
1f554f76 192
2489d6df 193`--restore` `<boolean>` ::
1f554f76
DM
194
195Mark this as restore task.
196
7cbed89a 197`--rootfs` `[volume=]<volume> [,acl=<1|0>] [,mountoptions=<opt[;opt...]>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::
1f554f76
DM
198
199Use volume as container root.
200
2489d6df 201`--searchdomain` `<string>` ::
1f554f76 202
c2993fe5 203Sets DNS search domains for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
9b3e4991 204
2489d6df 205`--ssh-public-keys` `<filepath>` ::
9b3e4991
DM
206
207Setup public SSH keys (one key per line, OpenSSH format).
1f554f76 208
5da3d723
TL
209`--start` `<boolean>` ('default =' `0`)::
210
211Start the CT after its creation finished successfully.
212
2489d6df 213`--startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
1f554f76 214
c2993fe5 215Startup 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.
1f554f76 216
907e4bc3 217`--storage` `<storage ID>` ('default =' `local`)::
1f554f76
DM
218
219Default Storage.
220
2489d6df 221`--swap` `<integer> (0 - N)` ('default =' `512`)::
1f554f76 222
4e7f60c2 223Amount of SWAP for the container in MB.
1f554f76 224
5c1699e5
TL
225`--tags` `<string>` ::
226
227Tags of the Container. This is only meta information.
228
2489d6df 229`--template` `<boolean>` ('default =' `0`)::
1f554f76
DM
230
231Enable/disable Template.
232
04d22a9f
TL
233`--timezone` `<string>` ::
234
235Time 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
236
2489d6df 237`--tty` `<integer> (0 - 6)` ('default =' `2`)::
1f554f76
DM
238
239Specify the number of tty available to the container
240
95895385
TL
241`--unique` `<boolean>` ::
242
243Assign a unique random ethernet address.
244+
245NOTE: Requires option(s): `restore`
246
2489d6df 247`--unprivileged` `<boolean>` ('default =' `0`)::
1f554f76 248
c2993fe5 249Makes the container run as unprivileged user. (Should not be modified manually.)
1f554f76 250
c5aa7e14 251`--unused[n]` `[volume=]<volume>` ::
1f554f76 252
c2993fe5 253Reference to unused volumes. This is used internally, and should not be modified manually.
1f554f76 254
1f554f76
DM
255*pct delsnapshot* `<vmid> <snapname>` `[OPTIONS]`
256
257Delete a LXC snapshot.
258
8dd66e12 259`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
260
261The (unique) ID of the VM.
262
013dc89f 263`<snapname>`: `<string>` ::
1f554f76
DM
264
265The name of the snapshot.
266
2489d6df 267`--force` `<boolean>` ::
1f554f76
DM
268
269For removal from config file, even if removing disk snapshots fails.
270
1c532546 271*pct destroy* `<vmid>` `[OPTIONS]`
1f554f76
DM
272
273Destroy the container (also delete all uses files).
274
8dd66e12 275`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
276
277The (unique) ID of the VM.
278
d2656385
TL
279`--destroy-unreferenced-disks` `<boolean>` ::
280
281If set, destroy additionally all disks with the VMID from all enabled storages which are not referenced in the config.
282
c5aa7e14
TL
283`--force` `<boolean>` ('default =' `0`)::
284
285Force destroy, even if running.
286
287`--purge` `<boolean>` ('default =' `0`)::
1c532546 288
c5aa7e14 289Remove container from all related configurations. For example, backup jobs, replication jobs or HA. Related ACLs and Firewall entries will *always* be removed.
1c532546 290
2c0dde61
DM
291*pct df* `<vmid>`
292
293Get the container's current disk usage.
294
8dd66e12 295`<vmid>`: `<integer> (100 - 999999999)` ::
2c0dde61
DM
296
297The (unique) ID of the VM.
298
c6d5bae8 299*pct enter* `<vmid>` `[OPTIONS]`
1f554f76
DM
300
301Launch a shell for the specified container.
302
8dd66e12 303`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
304
305The (unique) ID of the VM.
306
c6d5bae8
TL
307`--keep-env` `<boolean>` ('default =' `1`)::
308
309Keep 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.
310
311*pct exec* `<vmid> [<extra-args>]` `[OPTIONS]`
1f554f76
DM
312
313Launch a command inside the specified container.
314
8dd66e12 315`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
316
317The (unique) ID of the VM.
318
013dc89f 319`<extra-args>`: `<array>` ::
1f554f76
DM
320
321Extra arguments as array
322
c6d5bae8
TL
323`--keep-env` `<boolean>` ('default =' `1`)::
324
325Keep 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.
326
1f554f76
DM
327*pct fsck* `<vmid>` `[OPTIONS]`
328
329Run a filesystem check (fsck) on a container volume.
330
8dd66e12 331`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
332
333The (unique) ID of the VM.
334
4d47f125 335`--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>` ::
1f554f76
DM
336
337A volume on which to run the filesystem check
338
2489d6df 339`--force` `<boolean>` ('default =' `0`)::
1f554f76
DM
340
341Force checking, even if the filesystem seems clean
342
4772952b 343*pct fstrim* `<vmid>` `[OPTIONS]`
95895385 344
9d2e98ed
TL
345Run fstrim on a chosen CT and its mountpoints, except bind or read-only
346mountpoints.
95895385 347
8dd66e12 348`<vmid>`: `<integer> (100 - 999999999)` ::
95895385
TL
349
350The (unique) ID of the VM.
351
4772952b
TL
352`--ignore-mountpoints` `<boolean>` ::
353
354Skip all mountpoints, only do fstrim on the container root.
355
35a75dd3 356*pct help* `[OPTIONS]`
1f554f76
DM
357
358Get help about specified command.
359
35a75dd3 360`--extra-args` `<array>` ::
1f554f76 361
35a75dd3 362Shows help for a specific command
1f554f76 363
2489d6df 364`--verbose` `<boolean>` ::
1f554f76
DM
365
366Verbose output format.
367
1f554f76
DM
368*pct list*
369
370LXC container index (per node).
371
1f554f76
DM
372*pct listsnapshot* `<vmid>`
373
374List all snapshots.
375
8dd66e12 376`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
377
378The (unique) ID of the VM.
379
1f554f76
DM
380*pct migrate* `<vmid> <target>` `[OPTIONS]`
381
382Migrate the container to another node. Creates a new migration task.
383
8dd66e12 384`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
385
386The (unique) ID of the VM.
387
013dc89f 388`<target>`: `<string>` ::
1f554f76
DM
389
390Target node.
391
95895385
TL
392`--bwlimit` `<number> (0 - N)` ('default =' `migrate limit from datacenter or storage config`)::
393
394Override I/O bandwidth limit (in KiB/s).
395
2489d6df 396`--online` `<boolean>` ::
1f554f76
DM
397
398Use online/live migration.
399
2489d6df 400`--restart` `<boolean>` ::
6875b729
DM
401
402Use restart migration
403
c30bb419
TL
404`--target-storage` `<string>` ::
405
406Mapping 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.
407
2489d6df 408`--timeout` `<integer>` ('default =' `180`)::
6875b729
DM
409
410Timeout in seconds for shutdown for restart migration
411
9b3e4991
DM
412*pct mount* `<vmid>`
413
414Mount the container's filesystem on the host. This will hold a lock on the
415container and is meant for emergency maintenance only as it will prevent
416further operations on the container other than start and stop.
417
8dd66e12 418`<vmid>`: `<integer> (100 - 999999999)` ::
9b3e4991
DM
419
420The (unique) ID of the VM.
421
5370fa8c 422*pct move-volume* `<vmid> <volume> [<storage>] [<target-vmid>] [<target-volume>]` `[OPTIONS]`
27a7acb2 423
5370fa8c
TL
424Move a rootfs-/mp-volume to a different storage or to a different
425container.
27a7acb2 426
8dd66e12 427`<vmid>`: `<integer> (100 - 999999999)` ::
27a7acb2
DM
428
429The (unique) ID of the VM.
430
5370fa8c 431`<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>` ::
27a7acb2
DM
432
433Volume which will be moved.
434
907e4bc3 435`<storage>`: `<storage ID>` ::
27a7acb2
DM
436
437Target Storage.
438
8dd66e12 439`<target-vmid>`: `<integer> (100 - 999999999)` ::
5370fa8c
TL
440
441The (unique) ID of the VM.
442
443`<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>` ::
444
445The config key the volume will be moved to. Default is the source volume key.
446
95895385
TL
447`--bwlimit` `<number> (0 - N)` ('default =' `clone limit from datacenter or storage config`)::
448
449Override I/O bandwidth limit (in KiB/s).
450
27a7acb2
DM
451`--delete` `<boolean>` ('default =' `0`)::
452
453Delete the original volume after successful copy. By default the original is kept as an unused volume entry.
454
455`--digest` `<string>` ::
456
5370fa8c
TL
457Prevent changes if current configuration file has different SHA1 " .
458 "digest. This can be used to prevent concurrent modifications.
459
460`--target-digest` `<string>` ::
461
462Prevent changes if current configuration file of the target " .
463 "container has a different SHA1 digest. This can be used to prevent " .
464 "concurrent modifications.
465
466*pct move_volume*
467
468An alias for 'pct move-volume'.
27a7acb2 469
1c532546
TL
470*pct pending* `<vmid>`
471
472Get container configuration, including pending changes.
473
8dd66e12 474`<vmid>`: `<integer> (100 - 999999999)` ::
1c532546
TL
475
476The (unique) ID of the VM.
477
9b3e4991
DM
478*pct pull* `<vmid> <path> <destination>` `[OPTIONS]`
479
480Copy a file from the container to the local system.
481
8dd66e12 482`<vmid>`: `<integer> (100 - 999999999)` ::
9b3e4991
DM
483
484The (unique) ID of the VM.
485
013dc89f 486`<path>`: `<string>` ::
9b3e4991
DM
487
488Path to a file inside the container to pull.
489
013dc89f 490`<destination>`: `<string>` ::
9b3e4991
DM
491
492Destination
493
2489d6df 494`--group` `<string>` ::
9b3e4991
DM
495
496Owner group name or id.
497
2489d6df 498`--perms` `<string>` ::
9b3e4991 499
c2993fe5 500File permissions to use (octal by default, prefix with '0x' for hexadecimal).
9b3e4991 501
2489d6df 502`--user` `<string>` ::
9b3e4991
DM
503
504Owner user name or id.
505
9b3e4991
DM
506*pct push* `<vmid> <file> <destination>` `[OPTIONS]`
507
508Copy a local file to the container.
509
8dd66e12 510`<vmid>`: `<integer> (100 - 999999999)` ::
9b3e4991
DM
511
512The (unique) ID of the VM.
513
013dc89f 514`<file>`: `<string>` ::
9b3e4991
DM
515
516Path to a local file.
517
013dc89f 518`<destination>`: `<string>` ::
9b3e4991
DM
519
520Destination inside the container to write to.
521
2489d6df 522`--group` `<string>` ::
9b3e4991 523
c2993fe5 524Owner group name or id. When using a name it must exist inside the container.
9b3e4991 525
2489d6df 526`--perms` `<string>` ::
9b3e4991 527
c2993fe5 528File permissions to use (octal by default, prefix with '0x' for hexadecimal).
9b3e4991 529
2489d6df 530`--user` `<string>` ::
9b3e4991 531
c2993fe5 532Owner user name or id. When using a name it must exist inside the container.
9b3e4991 533
5c1699e5
TL
534*pct reboot* `<vmid>` `[OPTIONS]`
535
536Reboot the container by shutting it down, and starting it again. Applies
537pending changes.
538
8dd66e12 539`<vmid>`: `<integer> (100 - 999999999)` ::
5c1699e5
TL
540
541The (unique) ID of the VM.
542
543`--timeout` `<integer> (0 - N)` ::
544
545Wait maximal timeout seconds for the shutdown.
546
81a3384d
TL
547*pct remote-migrate* `<vmid> [<target-vmid>] <target-endpoint> --target-bridge <string> --target-storage <string>` `[OPTIONS]`
548
549Migrate container to a remote cluster. Creates a new migration task.
550EXPERIMENTAL feature!
551
8dd66e12 552`<vmid>`: `<integer> (100 - 999999999)` ::
81a3384d
TL
553
554The (unique) ID of the VM.
555
8dd66e12 556`<target-vmid>`: `<integer> (100 - 999999999)` ::
81a3384d
TL
557
558The (unique) ID of the VM.
559
907e4bc3 560`<target-endpoint>`: `apitoken=<PVEAPIToken=user@realm!token=SECRET> ,host=<ADDRESS> [,fingerprint=<FINGERPRINT>] [,port=<PORT>]` ::
81a3384d
TL
561
562Remote target endpoint
563
564`--bwlimit` `<integer> (0 - N)` ('default =' `migrate limit from datacenter or storage config`)::
565
566Override I/O bandwidth limit (in KiB/s).
567
568`--delete` `<boolean>` ('default =' `0`)::
569
570Delete the original CT and related data after successful migration. By default the original CT is kept on the source cluster in a stopped state.
571
572`--online` `<boolean>` ::
573
574Use online/live migration.
575
576`--restart` `<boolean>` ::
577
578Use restart migration
579
580`--target-bridge` `<string>` ::
581
582Mapping 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.
583
584`--target-storage` `<string>` ::
585
586Mapping 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.
587
588`--timeout` `<integer>` ('default =' `180`)::
589
590Timeout in seconds for shutdown for restart migration
591
e2d681b3
TL
592*pct rescan* `[OPTIONS]`
593
594Rescan all storages and update disk sizes and unused disk images.
595
596`--dryrun` `<boolean>` ('default =' `0`)::
597
598Do not actually write changes out to conifg.
599
8dd66e12 600`--vmid` `<integer> (100 - 999999999)` ::
e2d681b3
TL
601
602The (unique) ID of the VM.
603
1f554f76
DM
604*pct resize* `<vmid> <disk> <size>` `[OPTIONS]`
605
de0983cb 606Resize a container mount point.
1f554f76 607
8dd66e12 608`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
609
610The (unique) ID of the VM.
611
4d47f125 612`<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>` ::
1f554f76
DM
613
614The disk you want to resize.
615
013dc89f 616`<size>`: `\+?\d+(\.\d+)?[KMGT]?` ::
1f554f76 617
c2993fe5 618The 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.
1f554f76 619
2489d6df 620`--digest` `<string>` ::
1f554f76 621
c2993fe5 622Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
1f554f76 623
1f554f76
DM
624*pct restore* `<vmid> <ostemplate>` `[OPTIONS]`
625
626Create or restore a container.
627
8dd66e12 628`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
629
630The (unique) ID of the VM.
631
013dc89f 632`<ostemplate>`: `<string>` ::
1f554f76
DM
633
634The OS template or backup file.
635
9d2e98ed 636`--arch` `<amd64 | arm64 | armhf | i386 | riscv32 | riscv64>` ('default =' `amd64`)::
1f554f76
DM
637
638OS architecture type.
639
95895385 640`--bwlimit` `<number> (0 - N)` ('default =' `restore limit from datacenter or storage config`)::
27a7acb2 641
95895385 642Override I/O bandwidth limit (in KiB/s).
27a7acb2 643
2489d6df 644`--cmode` `<console | shell | tty>` ('default =' `tty`)::
1f554f76 645
c2993fe5 646Console 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).
1f554f76 647
2489d6df 648`--console` `<boolean>` ('default =' `1`)::
1f554f76
DM
649
650Attach a console device (/dev/console) to the container.
651
4772952b 652`--cores` `<integer> (1 - 8192)` ::
de0983cb
DM
653
654The number of cores assigned to the container. A container can use all available cores by default.
655
4772952b 656`--cpulimit` `<number> (0 - 8192)` ('default =' `0`)::
1f554f76 657
9b3e4991
DM
658Limit of CPU usage.
659+
c2993fe5 660NOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit.
1f554f76 661
4e7f60c2 662`--cpuunits` `<integer> (0 - 500000)` ('default =' `cgroup v1: 1024, cgroup v2: 100`)::
1f554f76 663
4e7f60c2 664CPU weight for a container, will be clamped to [1, 10000] in cgroup v2.
1f554f76 665
739d4d64
TL
666`--debug` `<boolean>` ('default =' `0`)::
667
668Try to be more verbose. For now this only enables debug log-level on start.
669
2489d6df 670`--description` `<string>` ::
1f554f76 671
8f4d9c87 672Description for the Container. Shown in the web-interface CT's summary. This is saved as comment inside the configuration file.
1f554f76 673
fa22697b
TL
674`--dev[n]` `[[path=]<Path>] [,gid=<integer>] [,mode=<Octal access mode>] [,uid=<integer>]` ::
675
676Device to pass through to the container
677
c5aa7e14 678`--features` `[force_rw_sys=<1|0>] [,fuse=<1|0>] [,keyctl=<1|0>] [,mknod=<1|0>] [,mount=<fstype;fstype;...>] [,nesting=<1|0>]` ::
4d47f125
TL
679
680Allow containers access to advanced features.
681
2489d6df 682`--force` `<boolean>` ::
1f554f76
DM
683
684Allow to overwrite existing container.
685
5f26e15b
TL
686`--hookscript` `<string>` ::
687
688Script that will be exectued during various steps in the containers lifetime.
689
2489d6df 690`--hostname` `<string>` ::
1f554f76
DM
691
692Set a host name for the container.
693
2489d6df 694`--ignore-unpack-errors` `<boolean>` ::
1f554f76
DM
695
696Ignore errors when extracting the template.
697
1c532546 698`--lock` `<backup | create | destroyed | disk | fstrim | migrate | mounted | rollback | snapshot | snapshot-delete>` ::
1f554f76 699
4e7f60c2 700Lock/unlock the container.
1f554f76 701
2489d6df 702`--memory` `<integer> (16 - N)` ('default =' `512`)::
1f554f76 703
4e7f60c2 704Amount of RAM for the container in MB.
1f554f76 705
7cbed89a 706`--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>]` ::
1f554f76 707
d2656385 708Use volume as container mount point. Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume.
1f554f76 709
2489d6df 710`--nameserver` `<string>` ::
1f554f76 711
c2993fe5 712Sets DNS server IP address for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
1f554f76 713
9d2e98ed 714`--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>]` ::
1f554f76
DM
715
716Specifies network interfaces for the container.
717
2489d6df 718`--onboot` `<boolean>` ('default =' `0`)::
1f554f76 719
4e7f60c2 720Specifies whether a container will be started during system bootup.
1f554f76 721
7af2edf9 722`--ostype` `<alpine | archlinux | centos | debian | devuan | fedora | gentoo | nixos | opensuse | ubuntu | unmanaged>` ::
1f554f76 723
c2993fe5 724OS 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.
1f554f76 725
5da3d723 726`--password` `<password>` ::
1f554f76
DM
727
728Sets root password inside container.
729
2489d6df 730`--pool` `<string>` ::
1f554f76
DM
731
732Add the VM to the specified pool.
733
2489d6df 734`--protection` `<boolean>` ('default =' `0`)::
1f554f76 735
c2993fe5 736Sets the protection flag of the container. This will prevent the CT or CT's disk remove/update operation.
1f554f76 737
7cbed89a 738`--rootfs` `[volume=]<volume> [,acl=<1|0>] [,mountoptions=<opt[;opt...]>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::
1f554f76
DM
739
740Use volume as container root.
741
2489d6df 742`--searchdomain` `<string>` ::
1f554f76 743
c2993fe5 744Sets DNS search domains for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
9b3e4991 745
2489d6df 746`--ssh-public-keys` `<filepath>` ::
9b3e4991
DM
747
748Setup public SSH keys (one key per line, OpenSSH format).
1f554f76 749
5da3d723
TL
750`--start` `<boolean>` ('default =' `0`)::
751
752Start the CT after its creation finished successfully.
753
2489d6df 754`--startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
1f554f76 755
c2993fe5 756Startup 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.
1f554f76 757
907e4bc3 758`--storage` `<storage ID>` ('default =' `local`)::
1f554f76
DM
759
760Default Storage.
761
2489d6df 762`--swap` `<integer> (0 - N)` ('default =' `512`)::
1f554f76 763
4e7f60c2 764Amount of SWAP for the container in MB.
1f554f76 765
5c1699e5
TL
766`--tags` `<string>` ::
767
768Tags of the Container. This is only meta information.
769
2489d6df 770`--template` `<boolean>` ('default =' `0`)::
1f554f76
DM
771
772Enable/disable Template.
773
04d22a9f
TL
774`--timezone` `<string>` ::
775
776Time 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
777
2489d6df 778`--tty` `<integer> (0 - 6)` ('default =' `2`)::
1f554f76
DM
779
780Specify the number of tty available to the container
781
95895385
TL
782`--unique` `<boolean>` ::
783
784Assign a unique random ethernet address.
785+
786NOTE: Requires option(s): `restore`
787
2489d6df 788`--unprivileged` `<boolean>` ('default =' `0`)::
1f554f76 789
c2993fe5 790Makes the container run as unprivileged user. (Should not be modified manually.)
1f554f76 791
c5aa7e14 792`--unused[n]` `[volume=]<volume>` ::
1f554f76 793
c2993fe5 794Reference to unused volumes. This is used internally, and should not be modified manually.
1f554f76 795
1f554f76
DM
796*pct resume* `<vmid>`
797
798Resume the container.
799
8dd66e12 800`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
801
802The (unique) ID of the VM.
803
4e7f60c2 804*pct rollback* `<vmid> <snapname>` `[OPTIONS]`
1f554f76
DM
805
806Rollback LXC state to specified snapshot.
807
8dd66e12 808`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
809
810The (unique) ID of the VM.
811
013dc89f 812`<snapname>`: `<string>` ::
1f554f76
DM
813
814The name of the snapshot.
815
4e7f60c2
TL
816`--start` `<boolean>` ('default =' `0`)::
817
818Whether the container should get started after rolling back successfully
819
1f554f76
DM
820*pct set* `<vmid>` `[OPTIONS]`
821
822Set container options.
823
8dd66e12 824`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
825
826The (unique) ID of the VM.
827
9d2e98ed 828`--arch` `<amd64 | arm64 | armhf | i386 | riscv32 | riscv64>` ('default =' `amd64`)::
1f554f76
DM
829
830OS architecture type.
831
2489d6df 832`--cmode` `<console | shell | tty>` ('default =' `tty`)::
1f554f76 833
c2993fe5 834Console 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).
1f554f76 835
2489d6df 836`--console` `<boolean>` ('default =' `1`)::
1f554f76
DM
837
838Attach a console device (/dev/console) to the container.
839
4772952b 840`--cores` `<integer> (1 - 8192)` ::
de0983cb
DM
841
842The number of cores assigned to the container. A container can use all available cores by default.
843
4772952b 844`--cpulimit` `<number> (0 - 8192)` ('default =' `0`)::
1f554f76 845
9b3e4991
DM
846Limit of CPU usage.
847+
c2993fe5 848NOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit.
1f554f76 849
4e7f60c2 850`--cpuunits` `<integer> (0 - 500000)` ('default =' `cgroup v1: 1024, cgroup v2: 100`)::
1f554f76 851
4e7f60c2 852CPU weight for a container, will be clamped to [1, 10000] in cgroup v2.
1f554f76 853
739d4d64
TL
854`--debug` `<boolean>` ('default =' `0`)::
855
856Try to be more verbose. For now this only enables debug log-level on start.
857
2489d6df 858`--delete` `<string>` ::
1f554f76
DM
859
860A list of settings you want to delete.
861
2489d6df 862`--description` `<string>` ::
1f554f76 863
8f4d9c87 864Description for the Container. Shown in the web-interface CT's summary. This is saved as comment inside the configuration file.
1f554f76 865
fa22697b
TL
866`--dev[n]` `[[path=]<Path>] [,gid=<integer>] [,mode=<Octal access mode>] [,uid=<integer>]` ::
867
868Device to pass through to the container
869
2489d6df 870`--digest` `<string>` ::
1f554f76 871
c2993fe5 872Prevent changes if current configuration file has different SHA1 digest. This can be used to prevent concurrent modifications.
1f554f76 873
c5aa7e14 874`--features` `[force_rw_sys=<1|0>] [,fuse=<1|0>] [,keyctl=<1|0>] [,mknod=<1|0>] [,mount=<fstype;fstype;...>] [,nesting=<1|0>]` ::
4d47f125
TL
875
876Allow containers access to advanced features.
877
5f26e15b
TL
878`--hookscript` `<string>` ::
879
880Script that will be exectued during various steps in the containers lifetime.
881
2489d6df 882`--hostname` `<string>` ::
1f554f76
DM
883
884Set a host name for the container.
885
1c532546 886`--lock` `<backup | create | destroyed | disk | fstrim | migrate | mounted | rollback | snapshot | snapshot-delete>` ::
1f554f76 887
4e7f60c2 888Lock/unlock the container.
1f554f76 889
2489d6df 890`--memory` `<integer> (16 - N)` ('default =' `512`)::
1f554f76 891
4e7f60c2 892Amount of RAM for the container in MB.
1f554f76 893
7cbed89a 894`--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>]` ::
1f554f76 895
d2656385 896Use volume as container mount point. Use the special syntax STORAGE_ID:SIZE_IN_GiB to allocate a new volume.
1f554f76 897
2489d6df 898`--nameserver` `<string>` ::
1f554f76 899
c2993fe5 900Sets DNS server IP address for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
1f554f76 901
9d2e98ed 902`--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>]` ::
1f554f76
DM
903
904Specifies network interfaces for the container.
905
2489d6df 906`--onboot` `<boolean>` ('default =' `0`)::
1f554f76 907
4e7f60c2 908Specifies whether a container will be started during system bootup.
1f554f76 909
7af2edf9 910`--ostype` `<alpine | archlinux | centos | debian | devuan | fedora | gentoo | nixos | opensuse | ubuntu | unmanaged>` ::
1f554f76 911
c2993fe5 912OS 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.
1f554f76 913
2489d6df 914`--protection` `<boolean>` ('default =' `0`)::
1f554f76 915
c2993fe5 916Sets the protection flag of the container. This will prevent the CT or CT's disk remove/update operation.
1f554f76 917
1c532546
TL
918`--revert` `<string>` ::
919
920Revert a pending change.
921
7cbed89a 922`--rootfs` `[volume=]<volume> [,acl=<1|0>] [,mountoptions=<opt[;opt...]>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::
1f554f76
DM
923
924Use volume as container root.
925
2489d6df 926`--searchdomain` `<string>` ::
1f554f76 927
c2993fe5 928Sets DNS search domains for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
1f554f76 929
2489d6df 930`--startup` `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
1f554f76 931
c2993fe5 932Startup 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.
1f554f76 933
2489d6df 934`--swap` `<integer> (0 - N)` ('default =' `512`)::
1f554f76 935
4e7f60c2 936Amount of SWAP for the container in MB.
1f554f76 937
5c1699e5
TL
938`--tags` `<string>` ::
939
940Tags of the Container. This is only meta information.
941
2489d6df 942`--template` `<boolean>` ('default =' `0`)::
1f554f76
DM
943
944Enable/disable Template.
945
04d22a9f
TL
946`--timezone` `<string>` ::
947
948Time 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
949
2489d6df 950`--tty` `<integer> (0 - 6)` ('default =' `2`)::
1f554f76
DM
951
952Specify the number of tty available to the container
953
2489d6df 954`--unprivileged` `<boolean>` ('default =' `0`)::
1f554f76 955
c2993fe5 956Makes the container run as unprivileged user. (Should not be modified manually.)
1f554f76 957
c5aa7e14 958`--unused[n]` `[volume=]<volume>` ::
1f554f76 959
c2993fe5 960Reference to unused volumes. This is used internally, and should not be modified manually.
1f554f76 961
1f554f76
DM
962*pct shutdown* `<vmid>` `[OPTIONS]`
963
9b3e4991
DM
964Shutdown the container. This will trigger a clean shutdown of the
965container, see lxc-stop(1) for details.
1f554f76 966
8dd66e12 967`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
968
969The (unique) ID of the VM.
970
2489d6df 971`--forceStop` `<boolean>` ('default =' `0`)::
1f554f76
DM
972
973Make sure the Container stops.
974
2489d6df 975`--timeout` `<integer> (0 - N)` ('default =' `60`)::
1f554f76
DM
976
977Wait maximal timeout seconds.
978
1f554f76
DM
979*pct snapshot* `<vmid> <snapname>` `[OPTIONS]`
980
981Snapshot a container.
982
8dd66e12 983`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
984
985The (unique) ID of the VM.
986
013dc89f 987`<snapname>`: `<string>` ::
1f554f76
DM
988
989The name of the snapshot.
990
2489d6df 991`--description` `<string>` ::
1f554f76
DM
992
993A textual description or comment.
994
9b3e4991 995*pct start* `<vmid>` `[OPTIONS]`
1f554f76
DM
996
997Start the container.
998
8dd66e12 999`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
1000
1001The (unique) ID of the VM.
1002
739d4d64
TL
1003`--debug` `<boolean>` ('default =' `0`)::
1004
1005If set, enables very verbose debug log-level on start.
1006
2489d6df 1007`--skiplock` `<boolean>` ::
9b3e4991
DM
1008
1009Ignore locks - only root is allowed to use this option.
1010
2c0dde61
DM
1011*pct status* `<vmid>` `[OPTIONS]`
1012
1013Show CT status.
1014
8dd66e12 1015`<vmid>`: `<integer> (100 - 999999999)` ::
2c0dde61
DM
1016
1017The (unique) ID of the VM.
1018
2489d6df 1019`--verbose` `<boolean>` ::
2c0dde61
DM
1020
1021Verbose output format
1022
9b3e4991 1023*pct stop* `<vmid>` `[OPTIONS]`
1f554f76 1024
9b3e4991
DM
1025Stop the container. This will abruptly stop all processes running in the
1026container.
1f554f76 1027
8dd66e12 1028`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
1029
1030The (unique) ID of the VM.
1031
907e4bc3
TL
1032`--overrule-shutdown` `<boolean>` ('default =' `0`)::
1033
1034Try to abort active 'vzshutdown' tasks before stopping.
1035
2489d6df 1036`--skiplock` `<boolean>` ::
9b3e4991
DM
1037
1038Ignore locks - only root is allowed to use this option.
1039
1f554f76
DM
1040*pct suspend* `<vmid>`
1041
5370fa8c 1042Suspend the container. This is experimental.
1f554f76 1043
8dd66e12 1044`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
1045
1046The (unique) ID of the VM.
1047
27a7acb2 1048*pct template* `<vmid>`
1f554f76
DM
1049
1050Create a Template.
1051
8dd66e12 1052`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
1053
1054The (unique) ID of the VM.
1055
1f554f76
DM
1056*pct unlock* `<vmid>`
1057
1058Unlock the VM.
1059
8dd66e12 1060`<vmid>`: `<integer> (100 - 999999999)` ::
1f554f76
DM
1061
1062The (unique) ID of the VM.
1063
9b3e4991
DM
1064*pct unmount* `<vmid>`
1065
1066Unmount the container's filesystem.
1067
8dd66e12 1068`<vmid>`: `<integer> (100 - 999999999)` ::
9b3e4991
DM
1069
1070The (unique) ID of the VM.
1071
1072