microsoft/openvmm
Publicmirrored from https://github.com/microsoft/openvmmAvailable
Guide/src/dev_guide/getting_started/linux.md
57lines · modeblame
3fb1f627Daniel Prilik1 years ago | 1 | # Getting started on Linux / WSL2 |
| 2 | | |
| 3 | This page provides instructions for installing the necessary dependencies to | |
| 4 | build OpenVMM or OpenHCL on Linux / WSL2. | |
| 5 | | |
| 6 | ## \[WSL2] Installing WSL2 | |
| 7 | | |
| 8 | To install Windows Subsystem for Linux, run the following command in an | |
| 9 | elevated Powershell window: | |
| 10 | | |
| 11 | ```powershell | |
| 12 | PS> wsl --install | |
| 13 | ``` | |
| 14 | | |
| 15 | This should install WSL2 using the default Ubuntu linux distribution. | |
| 16 | You can check that the installation completed successfully by running the | |
| 17 | following command in a Powershell window. | |
| 18 | ```powershell | |
| 19 | PS> wsl -l -v | |
| 20 | NAME STATE VERSION | |
| 21 | * Ubuntu Running 2 | |
| 22 | ``` | |
| 23 | Once that command has completed, you will need to open WSL to complete the | |
| 24 | installation and set your password. You can open WSL by typing `wsl` or `bash` | |
| 25 | into Command Prompt or Powershell, or by opening the "Ubuntu" Windows Terminal | |
| 26 | profile that should have been created. | |
| 27 | | |
| 28 | > If you intend to cross-compile OpenVMM for Windows, please ensure you are | |
| 29 | > running a recent version of Windows 11. Windows 10 is no longer supported as a | |
| 30 | > development platform, due to needed WHP APIs. | |
| 31 | | |
| 32 | All subsequent commands on this page must be run within WSL2. | |
| 33 | | |
| 34 | ## Installing Rust | |
| 35 | | |
| 36 | To build OpenVMM or OpenHCL, you first need to install Rust. | |
| 37 | | |
| 38 | The OpenVMM project actively tracks the latest stable release of Rust, though it | |
| 39 | may take a week or two after a new stable is released until OpenVMM switches | |
| 40 | over to it. | |
| 41 | | |
| 42 | Please follow the [official instructions](https://www.rust-lang.org/tools/install) to do so. | |
| 43 | | |
| 44 | ## Cloning the OpenVMM source | |
| 45 | | |
| 46 | **If using WSL2:** Do NOT clone the repo into Windows then try to access said | |
| 47 | clone from Linux. It will result in serious performance issues. | |
| 48 | | |
| 49 | ```bash | |
| 50 | $ cd path/to/where/you/clone/repos | |
| 51 | $ git clone https://github.com/microsoft/openvmm.git | |
| 52 | ``` | |
| 53 | | |
| 54 | ## Next Steps | |
| 55 | | |
| 56 | You are now ready to build [OpenVMM](./build_openvmm.md) or | |
| 57 | [OpenHCL](./build_openhcl.md)! |