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 2 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
7 changes: 6 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,12 @@
- 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, if running 64-bit executable on ARM64 OS or 64-bit OS, `DOTNET_ROOT_X64` is used.

Check failure on line 205 in docs/core/tools/dotnet-environment-variables.md

View workflow job for this annotation

GitHub Actions / lint

Trailing spaces 

docs/core/tools/dotnet-environment-variables.md:205:101 MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1] https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md009.md
2. If running 32-bit executable on 64-bit OS, `DOTNET_ROOT(x86)` is considered.
3. `DOTNET_ROOT` is used as a fallback.

### `DOTNET_HOST_PATH`

Expand Down
Loading