Skip to content

Document default 75% value for GCHeapHardLimitPercent in container environments #50280

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
+3 −2
Open

Document default 75% value for GCHeapHardLimitPercent in container environments #50280

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
35c6593
Initial plan
Copilot Dec 2, 2025
85fec48
Document default 75% value for GCHeapHardLimitPercent in container en…
Copilot Dec 2, 2025
f552eb5
Reword GCHeapHardLimitPercent documentation per reviewer feedback
Copilot Dec 2, 2025
d6dd0eb
Reference GCHeapHardLimitPercent section for default value instead of…
Copilot Dec 3, 2025
928a0b7
Apply suggestion from @agocke
agocke Dec 3, 2025
1b240fe
Apply suggestion from @agocke
agocke Dec 3, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions docs/core/runtime-config/garbage-collector.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -300,7 +300,7 @@ The following settings apply to all flavors of the GC:

- The heap hard limit is defined as the maximum commit size, in bytes, for the GC heap and GC bookkeeping.
- This setting only applies to 64-bit computers.
- If this limit isn't configured but the process is running in a memory-constrained environment, that is, inside a container with a specified memory limit, a default value is set. That default is the greater of 20 MB or 75% of the memory limit on the container.
- If running in a memory-constrained environment (e.g., a container) and this value is unset, the default value is either 20 MB or the [heap hard limit percent](#heap-hard-limit-percent) of the container limit, whichever is larger.
- This setting is ignored if the [Per-object-heap hard limits](#per-object-heap-hard-limits) are configured.

| | Setting name | Values | Version introduced |
Expand Down Expand Up @@ -339,7 +339,8 @@ The following settings apply to all flavors of the GC:

### Heap hard limit percent

- Specifies the heap hard limit as a percentage of the total physical memory. If the process is running in a memory-constrained environment, that is, inside a container with a specified memory limit, the total physical memory is the memory limit; otherwise it's what's available on the machine.
- Specifies the heap hard limit as a percentage of total physical memory.
- If the process runs inside an environment (e.g., a container) with a set memory limit, that limit is treated as the total physical memory. In such environments, the default value is 75%.
Copy link
Contributor

@gewarren gewarren Dec 3, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- If the process runs inside an environment (e.g., a container) with a set memory limit, that limit is treated as the total physical memory. In such environments, the default value is 75%.
- If the process runs inside an environment with a set memory limit (for example, a container), that limit is treated as the total physical memory. In such environments, the default value is 75%.

- This setting only applies to 64-bit computers.
- This setting is ignored if the [Per-object-heap hard limits](#per-object-heap-hard-limits) are configured or the [heap hard limit](#heap-hard-limit) is configured.

Expand Down