docs(providers): note Docker on Windows is unsupported - #329
Merged
Merged
Conversation
Add a warning to the provider installation prerequisites stating that Linux is the only supported platform. Docker Desktop for Windows, including the WSL 2 backend, may work but is not a supported setup and we do not offer support for problems with such deployments. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015bA95fWqDhGRJWFAvooqJw
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
The warning described the `as-provider` installer as the requestor case on a Unix-like platform, and implied a non-Unix provider install path exists. State that the command installs the provider bundle and needs Linux, and point requestors at their own installation instructions. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015bA95fWqDhGRJWFAvooqJw
The provider requirements said "a linux machine" but never said what that excludes, and the wallet restoration pages described the install as a "Unix-like platform (Linux or Mac)" case while linking to the provider instructions - which reads as if macOS providers were supported. Say explicitly on the installation page and in the FAQ that Linux is the only supported platform, macOS is not supported at all, and Windows via Docker Desktop may work but is unsupported. Reword the requestor-side restoration note to match. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015bA95fWqDhGRJWFAvooqJw
The requestor installation page offers Linux/Mac, Windows and generic Unix instructions side by side, which reads as equal support. Add a warning that only Linux is supported and the other platforms may work but are not covered by support. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015bA95fWqDhGRJWFAvooqJw
Point macOS and Windows users at a Linux virtual machine (with nested virtualization for providers, so /dev/kvm is available) or a Linux cloud instance for requestors. Note that such setups generally work fine, but are not officially supported either. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015bA95fWqDhGRJWFAvooqJw
A Linux VM is a real workaround on x86-64 Windows hosts, but not on a Mac: Apple Silicon can only run ARM64 guests, while the provider needs x86-64 with KVM, so nested virtualization does not help there. Point Mac users at a separate Linux machine or a Linux server with KVM instead, and say x86-64 explicitly in the requestor note. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015bA95fWqDhGRJWFAvooqJw
The x86-64 requirement was only implied by the prerequisites line. Say explicitly on the installation page and in the FAQ that ARM machines, Apple Silicon and ARM servers alike, cannot run a provider for now, on any operating system. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015bA95fWqDhGRJWFAvooqJw
Same statements, fewer words: drop the repeated "not officially supported" hedging, the per-platform re-explanations and the Apple Silicon ARM64 aside, and merge each note into two short sentences. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015bA95fWqDhGRJWFAvooqJw
prekucki
approved these changes
Aug 14, 2026
This branch was successfully deployed
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
3 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.
Adds a warning to the provider installation prerequisites: Linux is the only supported platform for running the provider in Docker. Docker Desktop for Windows (including the WSL 2 backend) may work, but it is not a supported setup and we do not provide support for problems with deployments running there.
🤖 Generated with Claude Code
https://claude.ai/code/session_015bA95fWqDhGRJWFAvooqJw