+1
日增长
17,472
stars
3,359
forks
103
watchers
75
prs
150
issues
1
releases
README
WebVM
This repository hosts the source code for https://webvm.io, a Linux virtual machine that runs in your browser.
Try out the new Alpine / Xorg / i3 graphical environment: https://webvm.io/alpine.html
What is WebVM?
WebVM is a server-less virtual environment running fully client-side in HTML5/WebAssembly. It's designed to be Linux ABI-compatible and runs an unmodified Debian distribution including many native development toolchains.
WebVM is powered by the CheerpX virtualization engine, which provides:
- x86-to-WebAssembly JIT compiler
- Virtual block-based file system
- Linux syscall emulator
- Safe, sandboxed client-side execution
Table of Contents
- Networking
- Development & Customization
- Deploy to GitHub Pages
- Local Serving & Image Configuration
- Claude AI Integration
- Community & Support
- Learn More
- License
[!NOTE]
Visit https://webvm.io to get started immediately in your browser. No setup required.
For local setup, custom image builds, and fork/deploy guidance, see Development & Customization.
Networking
WebVM supports Tailscale integration. So your browser VM can reach your private network and, with an exit node, the public internet too.
[!NOTE]
Some low-level networking operations (especially ICMP used by ping) are not currently available in this environment. For connectivity checks, use curl or wget.
Local network
1. Open the "Networking" panel from the sidebar
2. Click "Connect to Tailscale"
3. Log in (create a free account at tailscale.com if needed)
4. Click "Connect" when prompted
WebVM now has access to all machines in your Tailscale network!
Internet Usage Tips
[!TIP]
On slower connections there may be a short delay before initialisation. Connection status is shown as a colored dot on the button: orange = local network, green = global/internet. The button text shows your Tailscale IP address once connected.
To access the public internet from WebVM, set up an Exit Node on another device in your Tailscale network:
1. Follow the Tailscale Exit Node quickstart (sections: "Advertise a device as an exit node")
2. WebVM automatically uses the exit node once advertised
Using an Auth Key
As an alternative to interactive login, add your Tailscale auth key to the URL fragment:
https://webvm.io/authKey=
This is equivalent to Tailscale's --login-server option.
[!TIP]
If you also need a custom control server, add controlUrl in the same URL fragment and separate values with &, for example: authKey=...&controlUrl=....
Self-Hosting Tailscale with Headscale
We also support headscale, a selfhosted open source implementation of the Tailscale control server.
Because Headscale does not add CORS headers by default, you will need a proxy in front of it. See the Headscale reverse proxy setup docs for an example.
Once ready, add the following line to your location / block in your nginx config file.
nginx
if ($http_origin = "https://yourdomain.com") {
add_header 'Access-Control-AlloTop issues
#159PWA support4 comments · 2025-01-29#199Go runtime fails to initialize in WebVM: "failed to get system page size"3 comments · 2025-10-28#175`ping` command3 comments · 2025-03-16#158Go code, and nushell do not work in an alpine linux container I've created3 comments · 2025-01-18#7Device interfaces like USB, Serial & HID3 comments · 2022-02-02#143Arch + Gnome2 comments · 2024-11-21#82Support capturing stdout2 comments · 2023-06-23#153File timestamps not updating correctly.1 comments · 2024-12-24