* [PATCH docs 0/6] container documentation updates
@ 2026-11-08 21:35 666Goofy666
2026-11-08 21:35 ` [PATCH docs 1/6] fix #7852: pct: network: fix max number interfaces 666Goofy666
` (5 more replies)
0 siblings, 6 replies; 7+ messages in thread
From: 666Goofy666 @ 2026-11-08 21:35 UTC (permalink / raw)
To: pve-devel@lists.proxmox.com; +Cc: 666Goofy666
From: 666Goofy666 <666goofy666@proton.me>
hi,
here some commits to update the container doc page.
the main one is the fix for network interfaces.
others are separate changes that I found while reviewing
the documentation, so you can cherry-pick them individually.
- network interfaces: info in the ticket #7852
- snapshots: just fixing a typo in the example
- cgroups and systemd: the code use 232, probably beceause
systemd start implement in v230 and finish in 232
- configuration keys for LXC: settings have changed in LXC 2.1
the change in code to depreceated is made in
pve-container: `108c6cab98b091f82b725c98f198bada9752ccdc`
- cgroups memory: PVE 9 uses cgroups v2 so the settings changes
v1 `memory.memsw.limit_in_bytes` represent memory + swap.
v2 `memory.swap.max` represent only the swap,
pve-container: `722a07704836d61a131af8b982d208ccfe6ce336`
- mount points just typo
best regards,
666Goofy666 (6):
fix #7852: pct: network: fix max number interfaces
pct: snapshots: fix example variable
pct: cgroups: fix systemd supported version
pct: configuration: update configuration keys
pct: memory: change to cgroup v2
pct: mountpoints: fix mount point typo
pct.adoc | 30 ++++++++++++++----------------
1 file changed, 14 insertions(+), 16 deletions(-)
--
2.56.0
^ permalink raw reply [flat|nested] 7+ messages in thread
* [PATCH docs 1/6] fix #7852: pct: network: fix max number interfaces
2026-11-08 21:35 [PATCH docs 0/6] container documentation updates 666Goofy666
@ 2026-11-08 21:35 ` 666Goofy666
2026-11-08 21:35 ` [PATCH docs 2/6] pct: snapshots: fix example variable 666Goofy666
` (4 subsequent siblings)
5 siblings, 0 replies; 7+ messages in thread
From: 666Goofy666 @ 2026-11-08 21:35 UTC (permalink / raw)
To: pve-devel@lists.proxmox.com; +Cc: 666Goofy666
From: 666Goofy666 <666goofy666@proton.me>
Signed-off-by: 666Goofy666 <666goofy666@proton.me>
---
pct.adoc | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/pct.adoc b/pct.adoc
index cd3130f..25dc1fe 100644
--- a/pct.adoc
+++ b/pct.adoc
@@ -593,9 +593,9 @@ Network
[thumbnail="screenshot/gui-create-ct-network.png"]
-You can configure up to 10 network interfaces for a single container.
-The corresponding options are called `net0` to `net9`, and they can contain the
-following setting:
+You can configure up to 32 network interfaces for a single container.
+The corresponding options are called `net0` to `net31`, and they can contain the
+following settings:
include::generated/pct-network-opts.adoc[]
--
2.56.0
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [PATCH docs 2/6] pct: snapshots: fix example variable
2026-11-08 21:35 [PATCH docs 0/6] container documentation updates 666Goofy666
2026-11-08 21:35 ` [PATCH docs 1/6] fix #7852: pct: network: fix max number interfaces 666Goofy666
@ 2026-11-08 21:35 ` 666Goofy666
2026-11-08 21:35 ` [PATCH docs 3/6] pct: cgroups: fix systemd supported version 666Goofy666
` (3 subsequent siblings)
5 siblings, 0 replies; 7+ messages in thread
From: 666Goofy666 @ 2026-11-08 21:35 UTC (permalink / raw)
To: pve-devel@lists.proxmox.com; +Cc: 666Goofy666
From: 666Goofy666 <666goofy666@proton.me>
Signed-off-by: 666Goofy666 <666goofy666@proton.me>
---
pct.adoc | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/pct.adoc b/pct.adoc
index 25dc1fe..ed99e8b 100644
--- a/pct.adoc
+++ b/pct.adoc
@@ -1234,10 +1234,10 @@ file will look like this:
----
memory: 512
swap: 512
-parent: testsnaphot
+parent: testsnapshot
...
-[testsnaphot]
+[testsnapshot]
memory: 512
swap: 512
snaptime: 1457170803
--
2.56.0
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [PATCH docs 3/6] pct: cgroups: fix systemd supported version
2026-11-08 21:35 [PATCH docs 0/6] container documentation updates 666Goofy666
2026-11-08 21:35 ` [PATCH docs 1/6] fix #7852: pct: network: fix max number interfaces 666Goofy666
2026-11-08 21:35 ` [PATCH docs 2/6] pct: snapshots: fix example variable 666Goofy666
@ 2026-11-08 21:35 ` 666Goofy666
2026-11-08 21:35 ` [PATCH docs 4/6] pct: configuration: update configuration keys 666Goofy666
` (2 subsequent siblings)
5 siblings, 0 replies; 7+ messages in thread
From: 666Goofy666 @ 2026-11-08 21:35 UTC (permalink / raw)
To: pve-devel@lists.proxmox.com; +Cc: 666Goofy666
From: 666Goofy666 <666goofy666@proton.me>
Although systemd introduced cgroup v2 support in version 230, code
(unified_cgroupv2_support) requires 232 or newer to ensure broader
controller support.
Signed-off-by: 666Goofy666 <666goofy666@proton.me>
---
pct.adoc | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/pct.adoc b/pct.adoc
index ed99e8b..48cf56e 100644
--- a/pct.adoc
+++ b/pct.adoc
@@ -725,7 +725,7 @@ completely different way. Because of this, file system quotas are currently not
supported in a pure 'cgroupv2' environment.
'cgroupv2' support by the container's OS is needed to run in a pure 'cgroupv2'
-environment. Containers running 'systemd' version 231 or newer support
+environment. Containers running 'systemd' version 232 or newer support
'cgroupv2' footnote:[this includes all newest major versions of container
templates shipped by {pve}], as do containers not using 'systemd' as init
system footnote:[for example Alpine Linux].
--
2.56.0
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [PATCH docs 4/6] pct: configuration: update configuration keys
2026-11-08 21:35 [PATCH docs 0/6] container documentation updates 666Goofy666
` (2 preceding siblings ...)
2026-11-08 21:35 ` [PATCH docs 3/6] pct: cgroups: fix systemd supported version 666Goofy666
@ 2026-11-08 21:35 ` 666Goofy666
2026-11-08 21:35 ` [PATCH docs 5/6] pct: memory: change to cgroup v2 666Goofy666
2026-11-08 21:35 ` [PATCH docs 6/6] pct: mountpoints: fix mount point typo 666Goofy666
5 siblings, 0 replies; 7+ messages in thread
From: 666Goofy666 @ 2026-11-08 21:35 UTC (permalink / raw)
To: pve-devel@lists.proxmox.com; +Cc: 666Goofy666
From: 666Goofy666 <666goofy666@proton.me>
the format as change in LXC 2.1
Signed-off-by: 666Goofy666 <666goofy666@proton.me>
---
pct.adoc | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/pct.adoc b/pct.adoc
index 48cf56e..0d618ab 100644
--- a/pct.adoc
+++ b/pct.adoc
@@ -1209,13 +1209,13 @@ are treated as comments and are also ignored.
It is possible to add low-level, LXC style configuration directly, for example:
----
-lxc.init_cmd: /sbin/my_own_init
+lxc.init.cmd: /sbin/my_own_init
----
or
----
-lxc.init_cmd = /sbin/my_own_init
+lxc.init.cmd = /sbin/my_own_init
----
The settings are passed directly to the LXC low-level tools.
--
2.56.0
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [PATCH docs 5/6] pct: memory: change to cgroup v2
2026-11-08 21:35 [PATCH docs 0/6] container documentation updates 666Goofy666
` (3 preceding siblings ...)
2026-11-08 21:35 ` [PATCH docs 4/6] pct: configuration: update configuration keys 666Goofy666
@ 2026-11-08 21:35 ` 666Goofy666
2026-11-08 21:35 ` [PATCH docs 6/6] pct: mountpoints: fix mount point typo 666Goofy666
5 siblings, 0 replies; 7+ messages in thread
From: 666Goofy666 @ 2026-11-08 21:35 UTC (permalink / raw)
To: pve-devel@lists.proxmox.com; +Cc: 666Goofy666
From: 666Goofy666 <666goofy666@proton.me>
PVE9 no longer uses cgroups v1, reflect cgroup v2 memory and swap
limits, where swap is defined independently from the memory limit.
Signed-off-by: 666Goofy666 <666goofy666@proton.me>
---
pct.adoc | 12 +++++-------
1 file changed, 5 insertions(+), 7 deletions(-)
diff --git a/pct.adoc b/pct.adoc
index 0d618ab..6f8fab4 100644
--- a/pct.adoc
+++ b/pct.adoc
@@ -471,17 +471,15 @@ Memory
[thumbnail="screenshot/gui-create-ct-memory.png"]
-Container memory is controlled using the cgroup memory controller.
+Container memory is controlled using the cgroup v2 memory controller.
[horizontal]
-`memory`: :: Limit overall memory usage. This corresponds to the
-`memory.limit_in_bytes` cgroup setting.
-
-`swap`: :: Allows the container to use additional swap memory from the host
-swap space. This corresponds to the `memory.memsw.limit_in_bytes` cgroup
-setting, which is set to the sum of both value (`memory + swap`).
+`memory`: :: Limits the maximum memory usage of the container.
+This corresponds to the `memory.max` cgroup setting.
+`swap`: :: Limits the additional swap memory the container can use.
+This corresponds to the `memory.swap.max` cgroup setting.
[[pct_mount_points]]
Mount Points
--
2.56.0
^ permalink raw reply related [flat|nested] 7+ messages in thread
* [PATCH docs 6/6] pct: mountpoints: fix mount point typo
2026-11-08 21:35 [PATCH docs 0/6] container documentation updates 666Goofy666
` (4 preceding siblings ...)
2026-11-08 21:35 ` [PATCH docs 5/6] pct: memory: change to cgroup v2 666Goofy666
@ 2026-11-08 21:35 ` 666Goofy666
5 siblings, 0 replies; 7+ messages in thread
From: 666Goofy666 @ 2026-11-08 21:35 UTC (permalink / raw)
To: pve-devel@lists.proxmox.com; +Cc: 666Goofy666
From: 666Goofy666 <666goofy666@proton.me>
Signed-off-by: 666Goofy666 <666goofy666@proton.me>
---
pct.adoc | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/pct.adoc b/pct.adoc
index 6f8fab4..9333f0d 100644
--- a/pct.adoc
+++ b/pct.adoc
@@ -524,7 +524,7 @@ pct set 100 -mp0 thin1:10,mp=/path/in/container
----
will allocate a 10GB volume on the storage `thin1` and replace the volume ID
-place holder `10` with the allocated volume ID, and setup the moutpoint in the
+place holder `10` with the allocated volume ID, and setup the mount point in the
container at `/path/in/container`
--
2.56.0
^ permalink raw reply related [flat|nested] 7+ messages in thread
end of thread, other threads:[~2026-11-08 21:46 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-11-08 21:35 [PATCH docs 0/6] container documentation updates 666Goofy666
2026-11-08 21:35 ` [PATCH docs 1/6] fix #7852: pct: network: fix max number interfaces 666Goofy666
2026-11-08 21:35 ` [PATCH docs 2/6] pct: snapshots: fix example variable 666Goofy666
2026-11-08 21:35 ` [PATCH docs 3/6] pct: cgroups: fix systemd supported version 666Goofy666
2026-11-08 21:35 ` [PATCH docs 4/6] pct: configuration: update configuration keys 666Goofy666
2026-11-08 21:35 ` [PATCH docs 5/6] pct: memory: change to cgroup v2 666Goofy666
2026-11-08 21:35 ` [PATCH docs 6/6] pct: mountpoints: fix mount point typo 666Goofy666
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox