The "Linux Memory Overcommit" section of the docs only talks about host-wide behavior (vm.overcommit_memory, oom_score_adj), but a lot of installations now run Postgres in containers, where a cgroup memory limit is what actually triggers the OOM killer, regardless of the host's overcommit settings. The attached patch adds a short subsection covering this: how memory.max behaves with cgroup v2, what happens when a backend is killed, what counts towards the limit (including the huge pages caveat)

Edit
ID 7381
Title The "Linux Memory Overcommit" section of the docs only talks about host-wide behavior (vm.overcommit_memory, oom_score_adj), but a lot of installations now run Postgres in containers, where a cgroup memory limit is what actually triggers the OOM killer, regardless of the host's overcommit settings. The attached patch adds a short subsection covering this: how memory.max behaves with cgroup v2, what happens when a backend is killed, what counts towards the limit (including the huge pages caveat)
CI (CFBot) Not processed
Stats (from CFBot) Unknown
Tags Docs Only
Created 2026-10-01 22:24:31
Last modified 2026-10-01 22:24:53 (1 hour ago)
Latest email 2026-10-01 22:19:38 (1 hour ago)
Status
PG20-3 (2026-11-01 – 2026-11-30): Needs review
Target version
Authors Joao Detomini (joaodetomini)
Reviewers Become reviewer
Committer
Links
Emails
doc: Document Linux cgroup memory limits
First at 2026-10-01 22:19:38 by Joao Detomini <joao.detomini at enterprisedb.com>
Latest at 2026-10-01 22:19:38 by Joao Detomini <joao.detomini at enterprisedb.com>
Latest attachment (v1-0001-doc-Document-Linux-cgroup-memory-limits.patch) at 2026-10-01 22:19:38 from Joao Detomini <joao.detomini at enterprisedb.com>
    Attachment (v1-0001-doc-Document-Linux-cgroup-memory-limits.patch) at 2026-10-01 22:19:38 from Joao Detomini <joao.detomini at enterprisedb.com> (Patch: No)
History
When Who What
2026-10-01 22:24:31 Joao Detomini (joaodetomini) Attached mail thread CABH8dKwkp1_TzR7nxfvSpRSLD1b33xw7N_VLMLy3MiaEjAEPNw@mail.gmail.com
2026-10-01 22:24:31 Joao Detomini (joaodetomini) Created patch record
Edit