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 3 commits
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 only on Windows. On macOS and Linux it's disabled by default because of a command-line parsing issue ([dotnet/command-line-api#2812](https://github.com/dotnet/command-line-api/issues/2812)): when the native CLI is loaded as a NativeAOT shared library, `Environment.GetCommandLineArgs()` returns an empty array on those platforms, which causes command parsing to throw. It will be enabled on macOS and Linux once that issue is resolved. To opt out and route every invocation to the managed CLI, set this variable to `false`, `0`, `no`, or `off`. To explicitly enable it (for example, on macOS or Linux), set it to `true`, `1`, `yes`, or `on`.
Comment thread
baronfel 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