]> git.proxmox.com Git - pve-docs.git/blame - pct.conf.5-opts.adoc
pvecm: fix wrong quorum numbers
[pve-docs.git] / pct.conf.5-opts.adoc
CommitLineData
4d47f125 1`arch`: `<amd64 | arm64 | armhf | i386>` ('default =' `amd64`)::
71e16346
DM
2
3OS architecture type.
4
013dc89f 5`cmode`: `<console | shell | tty>` ('default =' `tty`)::
71e16346 6
c2993fe5 7Console 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).
71e16346 8
013dc89f 9`console`: `<boolean>` ('default =' `1`)::
71e16346
DM
10
11Attach a console device (/dev/console) to the container.
12
013dc89f 13`cores`: `<integer> (1 - 128)` ::
de0983cb
DM
14
15The number of cores assigned to the container. A container can use all available cores by default.
16
013dc89f 17`cpulimit`: `<number> (0 - 128)` ('default =' `0`)::
71e16346
DM
18
19Limit of CPU usage.
20+
c2993fe5 21NOTE: If the computer has 2 CPUs, it has a total of '2' CPU time. Value '0' indicates no CPU limit.
71e16346 22
013dc89f 23`cpuunits`: `<integer> (0 - 500000)` ('default =' `1024`)::
71e16346 24
c2993fe5 25CPU 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.
71e16346
DM
26+
27NOTE: You can disable fair-scheduler configuration by setting this to 0.
28
013dc89f 29`description`: `<string>` ::
71e16346
DM
30
31Container description. Only used on the configuration web interface.
32
e2d681b3 33`features`: `[fuse=<1|0>] [,keyctl=<1|0>] [,mount=<fstype;fstype;...>] [,nesting=<1|0>]` ::
4d47f125
TL
34
35Allow containers access to advanced features.
36
e2d681b3
TL
37`fuse`=`<boolean>` ('default =' `0`);;
38
39Allow using 'fuse' file systems in a container. Note that interactions between fuse and the freezer cgroup can potentially cause I/O deadlocks.
40
4d47f125
TL
41`keyctl`=`<boolean>` ('default =' `0`);;
42
43For unprivileged containers only: Allow the use of the keyctl() system call. This is required to use docker inside a container. By default unprivileged containers will see this system call as non-existent. This is mostly a workaround for systemd-networkd, as it will treat it as a fatal error when some keyctl() operations are denied by the kernel due to lacking permissions. Essentially, you can choose between running systemd-networkd or docker.
44
45`mount`=`<fstype;fstype;...>` ;;
46
47Allow mounting file systems of specific types. This should be a list of file system types as used with the mount command. Note that this can have negative effects on the container's security. With access to a loop device, mounting a file can circumvent the mknod permission of the devices cgroup, mounting an NFS file system can block the host's I/O completely and prevent it from rebooting, etc.
48
49`nesting`=`<boolean>` ('default =' `0`);;
50
51Allow nesting. Best used with unprivileged containers with additional id mapping. Note that this will expose procfs and sysfs contents of the host to the guest.
52
5f26e15b
TL
53`hookscript`: `<string>` ::
54
55Script that will be exectued during various steps in the containers lifetime.
56
013dc89f 57`hostname`: `<string>` ::
71e16346
DM
58
59Set a host name for the container.
60
4d47f125 61`lock`: `<backup | disk | migrate | mounted | rollback | snapshot | snapshot-delete>` ::
71e16346
DM
62
63Lock/unlock the VM.
64
013dc89f 65`memory`: `<integer> (16 - N)` ('default =' `512`)::
71e16346
DM
66
67Amount of RAM for the VM in MB.
68
5d9c884c 69`mp[n]`: `[volume=]<volume> ,mp=<Path> [,acl=<1|0>] [,backup=<1|0>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::
71e16346 70
c2993fe5
DM
71Use volume as container mount point.
72
013dc89f 73`acl`=`<boolean>` ;;
c2993fe5
DM
74
75Explicitly enable or disable ACL support.
76
013dc89f 77`backup`=`<boolean>` ;;
c2993fe5 78
de0983cb 79Whether to include the mount point in backups (only used for volume mount points).
c2993fe5
DM
80
81`mp`=`<Path>` ;;
82
de0983cb 83Path to the mount point as seen from inside the container.
2c0dde61
DM
84+
85NOTE: Must not contain any symlinks for security reasons.
c2993fe5 86
013dc89f 87`quota`=`<boolean>` ;;
c2993fe5
DM
88
89Enable user quotas inside the container (not supported with zfs subvolumes)
90
5d9c884c
DM
91`replicate`=`<boolean>` ('default =' `1`);;
92
93Will include this volume to a storage replica job.
94
013dc89f 95`ro`=`<boolean>` ;;
c2993fe5 96
de0983cb
DM
97Read-only mount point
98
013dc89f 99`shared`=`<boolean>` ('default =' `0`);;
de0983cb
DM
100
101Mark this non-volume mount point as available on all nodes.
102+
103WARNING: This option does not share the mount point automatically, it assumes it is shared already!
c2993fe5
DM
104
105`size`=`<DiskSize>` ;;
106
107Volume size (read only value).
108
109`volume`=`<volume>` ;;
110
111Volume, device or directory to mount into the container.
71e16346 112
013dc89f 113`nameserver`: `<string>` ::
71e16346 114
c2993fe5 115Sets DNS server IP address for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
71e16346 116
2489d6df 117`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>]` ::
71e16346
DM
118
119Specifies network interfaces for the container.
120
c2993fe5
DM
121`bridge`=`<bridge>` ;;
122
123Bridge to attach the network device to.
124
013dc89f 125`firewall`=`<boolean>` ;;
c2993fe5
DM
126
127Controls whether this interface's firewall rules should be used.
128
129`gw`=`<GatewayIPv4>` ;;
130
131Default gateway for IPv4 traffic.
132
133`gw6`=`<GatewayIPv6>` ;;
134
135Default gateway for IPv6 traffic.
136
137`hwaddr`=`<XX:XX:XX:XX:XX:XX>` ;;
138
139The interface MAC address. This is dynamically allocated by default, but you can set that statically if needed, for example to always have the same link-local IPv6 address. (lxc.network.hwaddr)
140
2489d6df 141`ip`=`<(IPv4/CIDR|dhcp|manual)>` ;;
c2993fe5
DM
142
143IPv4 address in CIDR format.
144
2489d6df 145`ip6`=`<(IPv6/CIDR|auto|dhcp|manual)>` ;;
c2993fe5
DM
146
147IPv6 address in CIDR format.
148
013dc89f 149`mtu`=`<integer> (64 - N)` ;;
c2993fe5
DM
150
151Maximum transfer unit of the interface. (lxc.network.mtu)
152
153`name`=`<string>` ;;
154
155Name of the network device as seen from inside the container. (lxc.network.name)
156
157`rate`=`<mbps>` ;;
158
159Apply rate limiting to the interface
160
013dc89f 161`tag`=`<integer> (1 - 4094)` ;;
c2993fe5
DM
162
163VLAN tag for this interface.
164
165`trunks`=`<vlanid[;vlanid...]>` ;;
166
167VLAN ids to pass through the interface
168
013dc89f 169`type`=`<veth>` ;;
c2993fe5
DM
170
171Network interface type.
172
013dc89f 173`onboot`: `<boolean>` ('default =' `0`)::
71e16346
DM
174
175Specifies whether a VM will be started during system bootup.
176
013dc89f 177`ostype`: `<alpine | archlinux | centos | debian | fedora | gentoo | opensuse | ubuntu | unmanaged>` ::
71e16346 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.
71e16346 180
013dc89f 181`protection`: `<boolean>` ('default =' `0`)::
71e16346 182
c2993fe5 183Sets the protection flag of the container. This will prevent the CT or CT's disk remove/update operation.
71e16346 184
5d9c884c 185`rootfs`: `[volume=]<volume> [,acl=<1|0>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]` ::
71e16346
DM
186
187Use volume as container root.
188
013dc89f 189`acl`=`<boolean>` ;;
c2993fe5
DM
190
191Explicitly enable or disable ACL support.
192
013dc89f 193`quota`=`<boolean>` ;;
c2993fe5
DM
194
195Enable user quotas inside the container (not supported with zfs subvolumes)
196
5d9c884c
DM
197`replicate`=`<boolean>` ('default =' `1`);;
198
199Will include this volume to a storage replica job.
200
013dc89f 201`ro`=`<boolean>` ;;
c2993fe5 202
de0983cb
DM
203Read-only mount point
204
013dc89f 205`shared`=`<boolean>` ('default =' `0`);;
de0983cb
DM
206
207Mark this non-volume mount point as available on all nodes.
208+
209WARNING: This option does not share the mount point automatically, it assumes it is shared already!
c2993fe5
DM
210
211`size`=`<DiskSize>` ;;
212
213Volume size (read only value).
214
215`volume`=`<volume>` ;;
216
217Volume, device or directory to mount into the container.
218
013dc89f 219`searchdomain`: `<string>` ::
71e16346 220
c2993fe5 221Sets DNS search domains for a container. Create will automatically use the setting from the host if you neither set searchdomain nor nameserver.
71e16346
DM
222
223`startup`: `[[order=]\d+] [,up=\d+] [,down=\d+] ` ::
224
c2993fe5 225Startup 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.
71e16346 226
013dc89f 227`swap`: `<integer> (0 - N)` ('default =' `512`)::
71e16346
DM
228
229Amount of SWAP for the VM in MB.
230
013dc89f 231`template`: `<boolean>` ('default =' `0`)::
71e16346
DM
232
233Enable/disable Template.
234
013dc89f 235`tty`: `<integer> (0 - 6)` ('default =' `2`)::
71e16346
DM
236
237Specify the number of tty available to the container
238
013dc89f 239`unprivileged`: `<boolean>` ('default =' `0`)::
71e16346 240
c2993fe5 241Makes the container run as unprivileged user. (Should not be modified manually.)
71e16346 242
013dc89f 243`unused[n]`: `<string>` ::
71e16346 244
c2993fe5 245Reference to unused volumes. This is used internally, and should not be modified manually.
71e16346 246