Skip to content

Document DOTNET_CLI_ENABLEAOT environment variable #54649

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
gewarren merged 5 commits into from
Jul 7, 2026
Merged

Document DOTNET_CLI_ENABLEAOT environment variable #54649

Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
40922ae
Document DOTNET_CLI_ENABLEAOT environment variable
baronfel Jul 6, 2026
d34b142
Note macOS exclusion for DOTNET_CLI_ENABLEAOT
baronfel Jul 6, 2026
b88ddc0
Update DOTNET_CLI_ENABLEAOT: default-on Windows only (macOS + Linux b…
baronfel Jul 6, 2026
3fcddf8
DOTNET_CLI_ENABLEAOT: rework flow and move default-platform caveat in…
baronfel Jul 6, 2026
e9a52b2
DOTNET_CLI_ENABLEAOT: note that Windows default becomes true in .NET …
baronfel Jul 6, 2026
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: 7 additions & 0 deletions docs/core/tools/dotnet-environment-variables.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -192,6 +192,7 @@ This section describes the following environment variables:
- [`DOTNET_SERVICING`](#dotnet_servicing)
- [`DOTNET_NOLOGO`](#dotnet_nologo)
- [`DOTNET_CLI_PERF_LOG`](#dotnet_cli_perf_log)
- [`DOTNET_CLI_ENABLEAOT`](#dotnet_cli_enableaot)
- [`DOTNET_GENERATE_ASPNET_CERTIFICATE`](#dotnet_generate_aspnet_certificate)
- [`DOTNET_ADD_GLOBAL_TOOLS_TO_PATH`](#dotnet_add_global_tools_to_path)
- [`DOTNET_CLI_TELEMETRY_OPTOUT`](#dotnet_cli_telemetry_optout)
Expand Down Expand Up @@ -324,6 +325,12 @@ Specifies whether .NET welcome and telemetry messages are displayed on the first

Specifies whether performance details about the current CLI session are logged. Enabled when set to `1`, `true`, or `yes`. This is disabled by default.

### `DOTNET_CLI_ENABLEAOT`

Specifies whether the .NET SDK uses its native (ahead-of-time compiled) CLI command-handling fast path. When enabled, common commands (such as command parsing, `dotnet --version`, and `dotnet --info`) are handled by a native entry point for faster startup, transparently falling back to the managed CLI for anything the fast path doesn't handle.

This fast path is enabled by default. To opt out and route every invocation to the managed CLI, set this variable to `false`, `0`, `no`, or `off`. To explicitly enable it, set it to `true`, `1`, `yes`, or `on`, or leave it unset.
Comment thread
gewarren marked this conversation as resolved.
Outdated

### `DOTNET_GENERATE_ASPNET_CERTIFICATE`

Specifies whether to generate an ASP.NET Core certificate. The default value is `true`, but this can be overridden by setting this environment variable to either `0`, `false`, or `no`.
Expand Down
Loading