Skip to content

Remove unsupported DNX-based DARC install instructions #6538

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
dkurepa merged 3 commits into from
Aug 4, 2026
Merged

Remove unsupported DNX-based DARC install instructions #6538

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
5156096
Initial plan
Copilot Aug 3, 2026
874f1d5
Remove unsupported DNX install docs
Copilot Aug 3, 2026
7609241
Document correct DNX invocation for DARC
Copilot Aug 3, 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
26 changes: 2 additions & 24 deletions docs/Darc.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -141,34 +141,12 @@ If the PowerShell script doesn't work for your environment, you can install darc
dotnet tool install --global Microsoft.DotNet.Darc --source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet-eng/nuget/v3/index.json --prerelease
```

**DNX Alternative Installation:**
If you prefer to run darc without installing it as a global tool, you can use DNX to execute the package directly. For example:

For environments where the standard installation doesn't work, you can use DNX (dotnet execute) to run darc without a global installation:

```
dnx tool install Microsoft.DotNet.Darc --source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet-eng/nuget/v3/index.json --prerelease
```

After installation with DNX, you can run darc commands using:

```
dnx Microsoft.DotNet.Darc --help
```

Or create an alias in your shell profile for convenience:

**PowerShell:**
```powershell
Set-Alias -Name darc -Value "dnx Microsoft.DotNet.Darc"
dnx --source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet-eng/nuget/v3/index.json --prerelease Microsoft.DotNet.Darc -- get-subscriptions
```
Comment on lines +144 to 148

**Bash/Zsh:**
```bash
alias darc="dnx Microsoft.DotNet.Darc"
```

**Note:** DNX is useful in containerized environments or CI/CD scenarios where you want to avoid global tool installations but still need to use darc functionality.

#### Step 2: Authentication:
Darc talks to the Maestro API which requires authentication.
Devs on the .NET team should have access to it through the "all FTE" security group. You can test this by running `darc get-channels` or by visiting [https://maestro.dot.net/](https://maestro.dot.net/).
Expand Down