0ct0pu5
/
webvm


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414
							<!DOCTYPE html>
<html lang="en" style="height:100%;">
  <meta property="og:image" content="https://webvm.io/assets/reddit.png"/>
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=1100, initial-scale=1.0">
    <title>WebVM - Linux virtualization in WebAssembly</title>

    <meta name="description" content="Server-less virtual machine, networking included, running browser-side in HTML5/WebAssembly. Code in any programming language inside this Linux terminal.">
    <meta name="keywords" content="WebVM, Virtual Machine, CheerpX, x86 virtualization, WebAssembly, Tailscale, JIT">
    <meta property="og:title" content="WebVM - Linux virtualization in WebAssembly" />
    <meta property="og:type" content="website" />
    <meta property="og:site_name" content="WebVM"/>
    <meta property="og:image" content="https://webvm.io/assets/social.png" />
    <meta name="twitter:card" content="summary_large_image" />
    <meta name="twitter:site" content="@leaningtech" />
    <meta name="twitter:title" content="WebVM - Linux virtualization in WebAssembly" />
    <meta name="twitter:description" content="Server-less virtual machine, networking included, running browser-side in HTML5/WebAssembly. Code in any programming language inside this Linux terminal.">
    <meta name="twitter:image" content="https://webvm.io/assets/social.png" />

    <!-- Apple iOS web clip compatibility tags -->
    <meta name="application-name" content="WebVM" />
    <meta name="apple-mobile-web-app-title" content="WebVM" />
    <meta name="apple-mobile-web-app-capable" content="yes" />
    <meta name="mobile-web-app-capable" content="yes" />
    <meta name="apple-mobile-web-app-status-bar-style" content="black" />
	 

    <link rel="shortcut icon" href="./tower.ico">
    <link rel="preconnect" href="https://fonts.googleapis.com">
    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
    <link rel="stylesheet" id="us-fonts-css" href="https://fonts.googleapis.com/css?family=Montserrat%3A300%2C400%2C500%2C600%2C700&amp;display=swap&amp;ver=6.0.2" media="all">
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/github-fork-ribbon-css/0.2.3/gh-fork-ribbon.min.css" />
    <link rel="stylesheet" href="./xterm/xterm.css" />
    <link rel="stylesheet" href="./scrollbar.css" />
    <style>.github-fork-ribbon:before { background-color: #ea1e69; }</style>
    <!-- Serviceworker script that adds the COI and CORS headers to the response headers in cases where the server does not support it. -->
    <script src="serviceWorker.js"></script>
    <script src="./xterm/xterm.js"></script>
    <script src="./xterm/xterm-addon-fit.js"></script>
    <script src="./xterm/xterm-addon-web-links.js"></script>
    <script src="network.js"></script>
    <script defer data-domain="webvm.io" src="https://plausible.leaningtech.com/js/script.js"></script>
  </head>

  <body style="margin:0;height:100%;background:black;color:white;overflow:hidden; display:flex; flex-direction: column; justify-content: space-between; height: 100%;">
    <a class="github-fork-ribbon right-bottom" href="https://github.com/leaningtech/webvm/" target="_blank" data-ribbon="Fork me on GitHub" title="Fork me on GitHub">Fork me on GitHub</a>
    <div>
      <div style="padding-top: 0.7em;padding-bottom: 0.7em;font-size: 0.3em; font-weight: 200;vertical-align:center;height: 120px;">
        <div style="margin-left: 20px; height: 100%; display: flex; align-items: center; justify-content: space-between;">
          <pre style="font-family: monospace; font-weight: 600; font-size: large; color: #ad7fa8;">

__      __   _  __   ____  __
\ \    / /__| |_\ \ / /  \/  |
 \ \/\/ / -_) '_ \ V /| |\/| |
  \_/\_/\___|_.__/\_/ |_|  |_|
          </pre>
          <div style="height:100%;display: flex; flex-direction: column;justify-content: space-between;">
            <div style="padding-top: 0.7em;font-size: 0.3em; font-weight: 200;vertical-align:center;height:50px;">
              <div style="margin-right: 10px; margin-left: 20px; height: 100%; display: flex; align-items: center; justify-content: flex-end;gap: 50px;">
                  <div style="padding-top: 0.7em;font-size: 0.3em; font-weight: 200;vertical-align:center;">
                    <a href="https://leaningtech.com" style="text-decoration: none; height: 100%;" target="_blank">
                      <div style="color: white; font-family: montserrat; font-weight: 400; font-size: large; height: 100%; display: flex; align-items: center;">
                        <span>Made with &#10084;&#65039; by </span>
                        <img src="assets/leaningtech.png" height="40px" style="margin-left: 5px;">
                      </div>
                    </a>
                  </div>
              </div>
            </div>
            <div style="padding-top: 0.7em;font-size: 0.3em; font-weight: 200;vertical-align:center;height:50px;">
              <div style="margin-right: 10px; margin-left: 20px; height: 100%; display: flex; align-items: center; justify-content: flex-end;gap: 50px;">
                <div style="color: white; font-family: montserrat; font-weight: 400; font-size: large; height: 100%; display: flex; align-items: center;">
                  <span>CPU </span>
                  <span id="cpuactivity" style="margin-left: 7px;">&#x1F7E2;</span>
                </div>
                <div style="color: white; font-family: montserrat; font-weight: 400; font-size: large; height: 100%; display: flex; align-items: center;">
                  <span>HDD </span>
                  <span id="hddactivity" style="margin-left: 7px;">&#x1F7E2;</span>
                </div>
		<a id="loginLink" style="user-select: text ;text-decoration: none; height: 100%;">
		  <div  style="color: white; font-family: montserrat; font-weight: 400; font-size: large; height: 100%; display: flex; align-items: center;">
                    <div style="position: relative;">
	              <span style="cursor: pointer" id="networkStatus">Connect via Tailscale </span>
	              <span style="cursor: pointer; position: absolute; right: 0px; visibility: hidden;" id="ipCopied">Copied! </span>
                    </div>
	            <img src="assets/tailscale.svg" height="35px" style="margin-left: 7px;">
		  </div>
		</a>
                <a href="https://discord.gg/yTNZgySKGa" style="text-decoration: none; height: 100%;" target="_blank">
                  <div style="color: white; font-family: montserrat; font-weight: 400; font-size: large; height: 100%; display: flex; align-items: center;">
                    <span>Join Discord </span>
                    <img src="assets/discord-mark-blue.svg" height="35px" style="margin-left: 7px;">
                  </div>
                </a>
                <a href="https://github.com/leaningtech/webvm/issues" style="text-decoration: none; height: 100%;" target="_blank">
                  <div style="color: white; font-family: montserrat; font-weight: 400; font-size: large; height: 100%; display: flex; align-items: center;">
                    <span>GitHub Issues </span>
                    <img src="assets/github-mark-white.svg" height="35px" style="margin-left: 5px;">
                  </div>
                </a>
              </div>
            </div>
          </div>
        </div>
      </div>
    </div>
    <div style="flex-grow:0; flex-shrink: 0; height:1px; width: 100%; background-color: white;">
    </div>
    <main style="display: flex; flex-direction: row; justify-content: space-between; margin: 5px; height: 100%;">
      <div style="flex-grow:1; height:100%;display:inline-block;margin:0;" class="scrollbar" id="console">
      </div>

    </main>
    <script>

	//Utility namespace to group all functionality related to printing (both error and non error) messages
	const color= "\x1b[1;35m";
	const bold= "\x1b[1;37m";
	const underline= "\x1b[94;4m";
	const normal= "\x1b[0m";
	var printOnTerm = {
		getAsciiText: function ()
		{
			var text = [
				"+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+",
				"|                                                                             |",
				"| WebVM is a server-less virtual Linux environment running fully client-side  |",
				"| in HTML5/WebAssembly.                                                       |",
				"|                                                                             |",
				"| WebVM is powered by the CheerpX virtualization engine, which 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.                                  |",
				"|                                                                             |",
				"| Your own WebVM with custom images via Dockerfile:                           |",
				"|                                                                             |",
				"| " + underline + "https://leaningtech.com/mini-webvm-your-linux-box-from-dockerfile-via-wasm" + normal +"  |",
				"|                                                                             |",
				"| Join WebVM: The Hackathon (11-14 October 2024)                              |",
				"|                                                                             |",
				"| " + underline + "https://cheerpx.io/hackathon" + normal + "                                                |",
				"|                                                                             |",
				"+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+",
				"",
				"   Welcome to WebVM. If unsure, try these examples:",
				"",
				"     python3 examples/python3/fibonacci.py ",
				"     gcc -o helloworld examples/c/helloworld.c && ./helloworld",
				"     objdump -d ./helloworld | less -M",
				"     vim examples/c/helloworld.c",
				"     curl --max-time 15 parrot.live  # requires networking",
				"",
				];
			return text;
		},
		getSharedArrayBufferMissingMessage: function ()
		{
			const isCustom = window.location.hostname !== "webvm.io";
			const isSecureContext = window.isSecureContext;
			const text = [
				"",
				"",
				color + "CheerpX could not start" + normal,
				"",
				"CheerpX uses SharedArrayBuffer, which is not available right now.",
				"",
				!isSecureContext && "  -  This page is not in a secure context. Serve over HTTPS or WSS.",
				!isSecureContext && "    " + underline + "https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts" + normal,
				isCustom && "  -  The document is not cross-origin isolated.",
				isCustom && "     " + underline + "https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer#security_requirements" + normal, 
				"  - Your browser might not support SharedArrayBuffer.",
				"    Since 2022, all major browsers support this feature.",
				"    " + underline + "https://caniuse.com/sharedarraybuffer" + normal,
			].filter(Boolean);

			return text;
		},
		getErrorMessage: function (error_message)
		{
			const text = [
				"",
				"",
				color + "CheerpX could not start" + normal,
				"",
				"CheerpX internal error message is:",
				error_message,
				"",
				"",
				"CheerpX is expected to work with recent desktop versions of Chrome, Edge, Firefox and Safari",
				"",
				"",
				"Give it a try from a desktop version / another browser!",
				]

			return text;
		},
		printMessage: function (text) {
			for (var i=0; i<text.length; i++)
			{
				term.write(text[i]);
				term.write('\n');
			}
		},
		printError: function (message)
		{
			this.printMessage(message);

			term.write("\n\n");

			function writeCustom(something)
			{
				term.write(something);
			}
		},
	};

	var consoleDiv = document.getElementById("console");

	//xterm.js related logic
	var term = new Terminal({cursorBlink:true,convertEol:true, fontFamily:"monospace", fontWeight: 400, fontWeightBold: 700});
	var fitAddon = new FitAddon.FitAddon();
	term.loadAddon(fitAddon);
	var linkAddon = new WebLinksAddon.WebLinksAddon();
	term.loadAddon(linkAddon);
	term.open(consoleDiv);
	term.scrollToTop();

	fitAddon.fit();
	window.addEventListener("resize", function(ev){fitAddon.fit();}, false);
	term.focus();
	var cxReadFunc = null;
	function writeData(buf)
	{
		term.write(new Uint8Array(buf));
	}
	function readData(str)
	{
		if(cxReadFunc == null)
			return;
		for(var i=0;i<str.length;i++)
			cxReadFunc(str.charCodeAt(i));
	}
	term.onData(readData);

	function hddCallback(state)
	{
		var h = document.getElementById("hddactivity");
		if(state == "ready")
			h.textContent = "\u{1F7E2}";
		else
			h.textContent = "\u{1F7E0}";
	}
	function cpuCallback(state)
	{
		var h = document.getElementById("cpuactivity");
		if(state == "ready")
			h.textContent = "\u{1F7E2}";
		else
			h.textContent = "\u{1F7E0}";
	}

	//Actual CheerpX and bash specific logic
	async function runBash()
	{
		// cmd, cwd, args and env are replaced by the Github actions workflow.
		var cmd = CMD;
		var args = ARGS;
		var env = ENV;
		var cwd = CWD;
		var device_type = DEVICE_TYPE;
		var image_url = IMAGE_URL;
		// Reasonable defaults for local deployments
		// var cmd = "/bin/bash";
		// var args = ["--login"];
		// var env = ["HOME=/home/user", "TERM=xterm", "USER=user", "SHELL=/bin/bash", "EDITOR=vim", "LANG=en_US.UTF-8", "LC_ALL=C"];
		// var cwd = "/home/user";
		// var device_type = "bytes";
		// var image_url = "/your_local_image.ext2";
		const structure = {
			cmd: cmd,
			args: args,
			env: env,
			cwd: cwd
		}
		if (typeof SharedArrayBuffer === "undefined")
		{
			printOnTerm.printError(printOnTerm.getSharedArrayBufferMissingMessage());
			return;
		}

		let networkInterface = setupNetworkInterface();

		async function runTest(cx)
		{
			var processCount = 0;
			function handleProcessCreated()
			{
				processCount++;
				plausible(`Process started: ${processCount}`);
				if(processCount == 5)
				{
					// Make sure no further event is reported
					cx.unregisterCallback("processCreated", handleProcessCreated);
				}
			}
			cx.registerCallback("processCreated", handleProcessCreated);
			cx.registerCallback("cpuActivity", cpuCallback);
			cx.registerCallback("diskActivity", hddCallback);
			registerNetworkLogin(cx, networkInterface);

			term.scrollToBottom();

			async function cxLogAndRun(cheerpx, cmd, args, env)
			{
				await cheerpx.run(cmd, args, env);
				printOnTerm.printMessage(" ");
			}

			cxReadFunc = cx.setCustomConsole(writeData, term.cols, term.rows);

			function preventDefaults (e) {
				e.preventDefault()
				e.stopPropagation()
			}
			consoleDiv.addEventListener("dragover", preventDefaults, false);
			consoleDiv.addEventListener("dragenter", preventDefaults, false);
			consoleDiv.addEventListener("dragleave", preventDefaults, false);
			consoleDiv.addEventListener("drop", preventDefaults, false);

			var opts = {env:structure.env, cwd:structure.cwd, uid: 1000, gid: 1000};
			while (true)
			{
				await cxLogAndRun(cx, structure.cmd, structure.args, opts);
			}
		}
		function failCallback(err)
		{
			printOnTerm.printError(printOnTerm.getErrorMessage(err));
		}
		// The device url and type are replaced by Github Actions.
		var blockDevice;
		switch (device_type)
		{
			case "cloud":
				try
				{
					blockDevice = await CheerpX.CloudDevice.create(image_url);
				}
				catch(e)
				{
					// Report the failure and try again with plain HTTP
					var wssProtocol = "wss:";
					if(image_url.startsWith(wssProtocol))
					{
						// WebSocket protocol failed, try agin using plain HTTP
						plausible("WS Disk failure");
						image_url = "https:" + image_url.substr(wssProtocol.length);
						blockDevice = await CheerpX.CloudDevice.create(image_url);
					}
					else
					{
						// No other recovery option
						throw e;
					}
				}
				break;
			case "bytes":
				try
				{
					blockDevice = await CheerpX.HttpBytesDevice.create(image_url);
				}
				catch(e)
				{
					printOnTerm.printError([e]);
					throw e;
				}
				break;
			case "github":
				blockDevice = await CheerpX.GitHubDevice.create(image_url);
				break;
			default:
				console.log("Unrecognized device type");
				return;
		}
		var overlayDevice = await CheerpX.OverlayDevice.create(blockDevice, await CheerpX.IDBDevice.create("block1"));
		var webDevice = await CheerpX.WebDevice.create("");
		var dataDevice = await CheerpX.DataDevice.create();
		CheerpX.Linux.create({mounts:[{type:"ext2",dev:overlayDevice,path:"/"},{type:"dir",dev:webDevice,path:"/app"},{type:"dir",dev:dataDevice,path:"/data"},{type:"devs",path:"/dev"},{type:"proc",path:"/proc"}], networkInterface: networkInterface}).then(runTest, failCallback);
	}
	function initialMessage()
	{
		printOnTerm.printMessage(printOnTerm.getAsciiText());
		console.log("Welcome. We appreciate curiosity, but be warned that keeping the DevTools open causes significant performance degradation and crashes.");
	}
	initialMessage();
	async function loadCX()
	{
		// Find the latest build
		var r = await fetch("https://cxrtnc.leaningtech.com/LATEST.txt");
		var url = await r.text();
		url = url.trim();
		var script = document.createElement('script');
		script.type = 'text/javascript';
		script.src = url;
		script.addEventListener("load", runBash, false);
		document.head.appendChild(script);
	}
	loadCX();
    </script>
  </body>
</html>