docs: expand Windows section with WSL, container, cross-compile, and Scoop options#2808
Open
turanalmammadov wants to merge 1 commit intocontainers:mainfrom
Open
docs: expand Windows section with WSL, container, cross-compile, and Scoop options#2808turanalmammadov wants to merge 1 commit intocontainers:mainfrom
turanalmammadov wants to merge 1 commit intocontainers:mainfrom
Conversation
The Windows section was a single sentence pointing to an open feature request. Users needed clear instructions. There are four practical options today; document all of them: 1. WSL 2 (recommended) — Install skopeo inside a WSL distribution using the normal Linux package manager steps. Most Windows 10/11 users already have or can enable WSL 2. 2. Container image — Run quay.io/skopeo/stable with Docker Desktop or Podman Desktop, no native installation required. Include a real copy-between-registries example. 3. Cross-compile from Linux / macOS — The existing cross-compilation section documents 'make bin/skopeo.OS.ARCH'. Add a Windows-specific example and note the CGO / libgpgme limitation. 4. Scoop — Note the community Scoop manifest as an unofficial option. Closes containers#715 Co-authored-by: Cursor <[email protected]>
mtrmac
reviewed
Feb 25, 2026
Contributor
mtrmac
left a comment
mtrmac
left a comment
There was a problem hiding this comment.
https://github.com/containers/skopeo/blob/main/CONTRIBUTING.md#sign-your-prs please, we can’t really even look at PRs with unclear copyright status.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #715
Problem
The Windows section of
install.mdwas a single sentence that simply pointed at an open issue. Users needed actionable guidance.What's added
Four practical options, all available today:
1. WSL 2 (recommended)
Simple step-by-step: enable WSL 2, install a distro, then follow the existing Ubuntu/Debian instructions. Works on Windows 10/11 with no extra tooling.
2. Container image via Docker or Podman
Run
quay.io/skopeo/stabledirectly with Docker Desktop or Podman Desktop. Includes a real copy-between-registries example usingdocker runandpodman run.3. Cross-compile from Linux / macOS
Points to the existing cross-compilation section (
make bin/skopeo.windows.amd64) with a note about thecontainers_image_openpgp/ no-CGO limitation that disables GPG features in the Windows binary.4. Scoop
Mentions the community Scoop manifest as an unofficial option with a caveat that it is not maintained by the Skopeo team.
No code changes.
Made with Cursor