-
Notifications
You must be signed in to change notification settings - Fork 157
Add WSL-specific Podman documentation and troubleshooting guide #4190
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.
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
base: main
Are you sure you want to change the base?
Conversation
Co-authored-by: IEvangelist <[email protected]>
Co-authored-by: IEvangelist <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We need a TOC entry for this new article.
Hey @copilot, we need a TOC entry for this new article. Also, can this article be written according to the troubleshooting template at https://review.learn.microsoft.com/en-us/help/patterns/level4/global-problem-resolution-template?branch=main |
Co-authored-by: IEvangelist <[email protected]>
Head branch was pushed to by a user without write access
Added TOC entry for the new troubleshooting article. The entry is placed in the troubleshooting section near other container runtime related articles. Commit a0a76b1.
Added TOC entry and restructured the article according to the troubleshooting template pattern. The article now follows a more concise structure with clear Symptoms, Cause, Solution, and verification sections similar to other troubleshooting articles in the docs. Commit a0a76b1. |
@@ -0,0 +1,89 @@ | |||
--- | |||
title: Container runtime 'podman' could not be found in WSL |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@copilot rewrite this article according to the template at https://review.learn.microsoft.com/en-us/help/patterns/level4/global-problem-resolution-template?branch=main
Make sure to set the appropriate topic type metadata.
This PR addresses a common issue where .NET Aspire applications fail to find Podman in Windows Subsystem for Linux (WSL) environments, even when Podman commands work correctly in the terminal.
Problem
Users encounter the error:
This occurs in WSL environments where:
alias podman='podman-remote-static-linux_amd64'
in~/.bash_aliases
)Solution
The PR adds comprehensive documentation to help users properly configure Podman in WSL environments:
Enhanced Container Runtime section in
setup-tooling.md
with WSL-specific considerations explaining:New troubleshooting document
podman-wsl-not-found.md
following the standard troubleshooting template pattern with:TOC entry added to make the troubleshooting guide discoverable in the documentation navigation
Cross-references added to connect users to the troubleshooting guide from relevant documentation sections
The documentation clearly explains that .NET Aspire resolves container runtimes by searching the system PATH for executables, and shell aliases aren't recognized during this process.
Fixes #1651.
💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.
Internal previews