Skip to content

Correct Snap alias and symlink commands for .NET 10 SDK on Ubuntu 24.04.3#54806

Merged
adegeo merged 11 commits into
mainfrom
copilot/fix-snap-setup-commands-ubuntu
Jul 16, 2026
Merged

Correct Snap alias and symlink commands for .NET 10 SDK on Ubuntu 24.04.3#54806
adegeo merged 11 commits into
mainfrom
copilot/fix-snap-setup-commands-ubuntu

Conversation

Copilot AI commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

On Ubuntu 24.04.3, the documented .NET 10 Snap recovery commands were incorrect: the alias target used a non-existent app name, and the symlink path omitted usr/bin. This update adjusts the troubleshooting commands so they match the current dotnet-sdk-100 Snap layout.

  • Troubleshooting: dotnet command alias

    • Updated the .NET 9+ alias command to target the package command that exists in dotnet-sdk-100.
  • Troubleshooting: SDK resolution via symlink

    • Updated the .NET 9+ symlink source path to point to the actual dotnet binary location under the Snap mount.
# .NET 9+
sudo snap alias dotnet-sdk-100 dotnet
ln -s /snap/dotnet-sdk-100/current/usr/bin/dotnet /usr/local/bin/dotnet

Internal previews

📄 File 🔗 Preview link
docs/core/install/linux-snap-sdk.md docs/core/install/linux-snap-sdk

Copilot AI self-assigned this Jul 15, 2026
Copilot AI review requested due to automatic review settings July 15, 2026 18:17
Copilot AI removed the request for review from Copilot July 15, 2026 18:17
Copilot AI linked an issue Jul 15, 2026 that may be closed by this pull request
Copilot AI requested review from Copilot and removed request for Copilot July 15, 2026 18:19
Copilot AI changed the title [WIP] Fix commands to setup Snap with SDK on Ubuntu 24.04.3 Correct Snap alias and symlink commands for .NET 10 SDK on Ubuntu 24.04.3 Jul 15, 2026
Copilot AI requested a review from adegeo July 15, 2026 18:20
@adegeo

adegeo commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

@copilot there is more that needs to change here (use the editor agent):

  1. .NET SDK 8 was republished as a standalone snap package, just like 9 and 10. Remove all references to the old "8 and prior" and the package dotnet-sdk specifying a channel. The instructions are now the same from 8 (lowest version currently supported) to the latest.
  2. Alias is no longer applied. The main way to map the dotnet command is to use the link specified in the troubleshooting area. Promote that troubleshooting information into the procedure step and remove it from the troubleshooting area.
  3. The DOTNET_ROOT path is /snap/dotnet-sdk-100/current/usr/lib/dotnet where 100 is the version of the SDK.
  4. In all examples use the latest, which is dotnet-sdk-100 but when appropriate mention that this is the version of the SDK you want to install, and the latest SDK supports targeting lower runtimes.

Copilot AI requested review from Copilot and removed request for Copilot July 15, 2026 18:58

Copilot AI commented Jul 15, 2026

Copy link
Copy Markdown
Contributor Author

@copilot there is more that needs to change here (use the editor agent):

  1. .NET SDK 8 was republished as a standalone snap package, just like 9 and 10. Remove all references to the old "8 and prio...

Addressed in commit 208f8b06.

Updated linux-snap-sdk.md to:

  • Use version-specific Snap packages for .NET 8, 9, and 10 (dotnet-sdk-80/90/100) and remove old dotnet-sdk --channel guidance.
  • Promote dotnet command mapping into the main procedure, remove alias guidance from troubleshooting, and keep troubleshooting focused on verification steps.
  • Update DOTNET_ROOT to /snap/dotnet-sdk-100/current/usr/lib/dotnet with version substitution guidance.
  • Use dotnet-sdk-100 in examples and clarify that latest SDK can target lower runtimes.

Comment thread docs/core/install/linux-snap-sdk.md Outdated
Comment thread docs/core/install/linux-snap-sdk.md Outdated
Copilot AI requested review from Copilot and removed request for Copilot July 15, 2026 19:16
Copilot AI requested a review from adegeo July 15, 2026 19:17
Copilot AI requested review from Copilot and removed request for Copilot July 15, 2026 19:18
Updated the installation date and modified instructions for clarity regarding the .NET SDK snap package installation. Added a note about substituting the package version in commands.
Copilot AI review requested due to automatic review settings July 15, 2026 19:35
@adegeo adegeo marked this pull request as ready for review July 15, 2026 19:35
@adegeo adegeo requested a review from a team as a code owner July 15, 2026 19:35
@adegeo adegeo enabled auto-merge (squash) July 15, 2026 19:35

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the Snap-based .NET SDK install and troubleshooting guidance to better match the current dotnet-sdk-100 layout on Ubuntu 24.04.3, including the symlink target for the dotnet binary and revised install/setup steps.

Changes:

  • Updates the install guidance to focus on version-specific Snap identifiers (for example, dotnet-sdk-100) and refreshes the package table.
  • Moves “dotnet command mapping” into the main flow via a symlink to /snap/.../usr/bin/dotnet, and updates DOTNET_ROOT to /snap/.../usr/lib/dotnet.
  • Simplifies troubleshooting by removing the dedicated “dotnet terminal command doesn’t work” alias section and pointing users back to the main setup steps.

Comment thread docs/core/install/linux-snap-sdk.md
Comment thread docs/core/install/linux-snap-sdk.md Outdated
Comment thread docs/core/install/linux-snap-sdk.md
adegeo and others added 3 commits July 15, 2026 12:40
Removed the linux-release-wait include from the installation instructions.
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Added instructions for creating a symbolic link for dotnet.

@BillWagner BillWagner left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This LGTM. I did have one question that readers might have.

Comment thread docs/core/install/linux-snap-sdk.md
auto-merge was automatically disabled July 15, 2026 20:32

Head branch was pushed to by a user without write access

Copilot AI requested a review from adegeo July 15, 2026 20:33
@adegeo adegeo enabled auto-merge (squash) July 15, 2026 20:49

@BillWagner BillWagner left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This LGTM. Let's :shipit:

@adegeo adegeo merged commit 7976fc7 into main Jul 16, 2026
11 checks passed
@adegeo adegeo deleted the copilot/fix-snap-setup-commands-ubuntu branch July 16, 2026 13:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Commands to setup Snap with SDK on Ubuntu 24.04.3 don't work

4 participants