Skip to content

Clarify Windows WSL installation notes#2147

Merged
krichprollsch merged 3 commits intolightpanda-io:mainfrom
Gujiassh:docs/windows-wsl-instructions
Apr 15, 2026
Merged

Clarify Windows WSL installation notes#2147
krichprollsch merged 3 commits intolightpanda-io:mainfrom
Gujiassh:docs/windows-wsl-instructions

Conversation

@Gujiassh
Copy link
Copy Markdown
Contributor

Summary

  • explain how to install Lightpanda via WSL using the Linux steps
  • recommend installing automation clients like Puppeteer on the Windows host for CDP control

Testing

  • not run (docs only)

@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 12, 2026

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@Gujiassh
Copy link
Copy Markdown
Contributor Author

I have read the CLA Document and I hereby sign the CLA

Comment thread README.md Outdated
[MacOS x86_64 is also available](https://github.com/lightpanda-io/browser/releases/tag/nightly)

*For Windows + WSL2*
### Windows (via WSL2)
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.

I would keep the same formatting as Linux and macOS

@Gujiassh
Copy link
Copy Markdown
Contributor Author

Updated the Windows install section to match the existing Linux/macOS formatting.

Comment thread README.md Outdated
Comment on lines +69 to +70
Lightpanda runs inside WSL when invoked from a WSL shell; follow the Linux install steps above in that environment.
Install automation clients such as Puppeteer or Playwright on the Windows host so they can drive Lightpanda through CDP over the mapped ports.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Suggested change
Lightpanda runs inside WSL when invoked from a WSL shell; follow the Linux install steps above in that environment.
Install automation clients such as Puppeteer or Playwright on the Windows host so they can drive Lightpanda through CDP over the mapped ports.
Lightpanda has no native Windows binary. Install it inside WSL following the Linux steps above.
WSL not installed? Run from an **administrator** shell: `wsl --install`, restart, then `wsl`.
See [Microsoft's WSL install guide](https://learn.microsoft.com/en-us/windows/wsl/install) for details.
Your automation client (Puppeteer, Playwright, etc.) can run either inside WSL or on the Windows host — WSL forwards `localhost:9222` automatically.

@Gujiassh
Copy link
Copy Markdown
Contributor Author

Applied the WSL wording suggestion on the existing branch.

Updated in b15fc158:

  • clarified that there is no native Windows binary
  • added the wsl --install bootstrap hint with the Microsoft guide link
  • clarified that the automation client can run either inside WSL or on the Windows host via forwarded localhost:9222

@krichprollsch krichprollsch merged commit d278560 into lightpanda-io:main Apr 15, 2026
1 check passed
@github-actions github-actions bot locked and limited conversation to collaborators Apr 15, 2026
@krichprollsch
Copy link
Copy Markdown
Member

thanks @Gujiassh for the contribution and thanks @cdebled for your review 🙏

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants