Skip to content

Clarify DOTNET_ROOT documentation #47059

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

Merged
merged 12 commits into from
Jul 28, 2025
Merged

Clarify DOTNET_ROOT documentation #47059

Changes from all commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
15c5975
Clarify DOTNET_ROOT documentation
Youssef1313 Jul 2, 2025
74925ab
Reword
Youssef1313 Jul 2, 2025
f873577
Update docs/core/tools/dotnet-environment-variables.md
Youssef1313 Jul 2, 2025
976085d
Update docs/core/tools/dotnet-environment-variables.md
Youssef1313 Jul 2, 2025
d102dca
Update docs/core/tools/dotnet-environment-variables.md
Youssef1313 Jul 2, 2025
39f75ef
Update dotnet-environment-variables.md
Youssef1313 Jul 2, 2025
8c44ae4
Update dotnet-environment-variables.md
Youssef1313 Jul 2, 2025
bae9a00
Update docs/core/tools/dotnet-environment-variables.md
Youssef1313 Jul 2, 2025
3b624d3
Apply suggestion from @gewarren
nohwnd Jul 22, 2025
8e9e8ef
Apply suggestion from @gewarren
nohwnd Jul 22, 2025
485b8b6
Apply suggestion from @gewarren
nohwnd Jul 22, 2025
226e54b
Apply suggestion from @gewarren
nohwnd Jul 22, 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
10 changes: 9 additions & 1 deletion docs/core/tools/dotnet-environment-variables.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -199,7 +199,15 @@ Specifies the location of the .NET runtimes, if they are not installed in the de
- GitHub issue [dotnet/core#7699](https://github.com/dotnet/core/issues/7699)
- GitHub issue [dotnet/runtime#79237](https://github.com/dotnet/runtime/issues/79237)

This environment variable is used only when running apps via generated executables (apphosts). `DOTNET_ROOT(x86)` is used instead when running a 32-bit executable on a 64-bit OS. `DOTNET_ROOT_X64` is used instead when running a 64-bit executable on an ARM64 OS.
These environment variables are used only when running apps via generated executables (apphosts). The order in which the environment variables are considered is:

1. `DOTNET_ROOT_<ARCH>`, where `<ARCH>` is the architecture of the running executable (apphost).
For example:
- `DOTNET_ROOT_ARM64` is used for an Arm64 process.
- `DOTNET_ROOT_X64` is used for an x64 process. This process might be running on x64 or Arm64 architecture.
- `DOTNET_ROOT_X86` is used for an x86 process. This process might be running on x86 or x64 architecture.
2. `DOTNET_ROOT(x86)` is used when a 32-bit process is running on 64-bit Windows. In other cases, this environment variable is ignored.
3. `DOTNET_ROOT`.

### `DOTNET_HOST_PATH`

Expand Down