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

Open
baronfel wants to merge 5 commits into
base: main
Choose a base branch
from
+13 −0
Open

Document DOTNET_CLI_ENABLEAOT environment variable #54649

Changes from all 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
13 changes: 13 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,18 @@ 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-line 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.

Set this variable to control the fast path explicitly:

- To enable it, set the variable to `true`, `1`, `yes`, or `on`.
- To disable it and route every invocation to the managed CLI, set the variable to `false`, `0`, `no`, or `off`.

> [!NOTE]
> Starting in .NET 11 Preview 7, this fast path is enabled by default (`true`) 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-line parsing to throw. It will be enabled by default on macOS and Linux once that issue is resolved. In the meantime, you can opt in early on those platforms by setting the variable to a value that enables it.

### `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