2.9 KiB
WebVM
This repository hosts the source code for https://webvm.io, a Linux virtual machine that runs in your browser.
WebVM is a server-less virtual environment running fully client-side in HTML5/WebAssembly. It's designed to be Linux ABI-compatible. It runs an unmodified Debian distribution including many native development toolchains.
WebVM is powered by the CheerpX virtualization engine, and enables safe, sandboxed client-side execution of x86 binaries on any browser. CheerpX includes an x86-to-WebAssembly JIT compiler, a virtual block-based file system, and a Linux syscall emulator.
How to: enable networking
- Go to https://webvm.io.
- Click "Tailscale Login" in the top right corner.
- Log in to Tailscale (create an account if you don't have one).
- If you are unfamiliar with Tailscale or would like additional information see WebVM and Tailscale.
How to: fork and deploy
- Fork the repository.
- Enable Github pages in settings.
- Click on
Settings. - Go to the
Pagessection. - Select
Github Actionsas the source.
- Click on
- Run the workflow.
- Go to the forked repository its Github actions tab.
- Accept the prompt.
- Click on the workflow named
Deploy. - Click
Run workflowand then once moreRun workflow.
After the action completes, which takes a few minutes, it will show the URL to the GitHub Pages site below the deploy_to_github_pages job.
Bugs and Issues
Please use Issues to report any bug. Or come to say hello / share your feedback on Discord.
Browsers support
WebVM and CheerpX are compatible with any browser, both Desktop and Mobile, provided support for SAB, IndexedDB, and the device having enough memory.
More links
Thanks to...
This project depends on:
- CheerpX, made by Leaning Technologies for the virtualization part
- xterm.js, https://xtermjs.org/, for providing the Web-based terminal emulator
- Tailscale for the networking component
- lwIP for the TCP/IP stack, compiled to the Web by Cheerp
License
Copyright (c) Leaning Technologies Limited. All rights reserved.