Onboarding: Ubuntu
We will soon support enhanced Ubuntu VMs for Hyper-V through our VM gallery. Alternatively, you can achieve a similar experience to what you will find in the VM gallery by manually installing and configuring your own VM with the scripts found in this repo.
You need to be on Windows 10 April 2018 update (1803) or later. Virtualization must be enabled in the BIOS and you must have the Hyper-V feature turned on (Note: Windows 10 Home does not support Hyper-V).
Please make sure you have an Ubuntu Desktop image. These steps will not work for Server-based images. From a clean install of an Ubuntu 18.04 image, issue the following commands in a terminal:
wget https://raw.githubusercontent.com/Microsoft/linux-vm-tools/master/ubuntu/18.04/install.sh
sudo chmod +x install.sh
sudo ./install.sh
After you’ve run your scripts, shut down your VM. On your host machine in an Administrator powershell prompt, execute this command:
Set-VM -VMName <your_vm_name> -EnhancedSessionTransportType HvSocket
Start your virtual machine and connect. You will be greeted with a connection prompt windows that asks for a screen resolution--this will indicate that everything is installed correctly.
This will take you to an xorg login. This indicates that you've successfully brokered a connection and that the xrdp service is running. Login to begin your session.
NOTE: Enabling auto-login for your Ubuntu user causes an issue that will block enhanced mode from successfully connecting. Please ensure auto-login is DISABLED.
Please make sure you have an Ubuntu Desktop image. These steps will not work for Server-based images. From a clean install of an Ubuntu 16.04 image, issue the following commands in a terminal:
wget https://raw.githubusercontent.com/Microsoft/linux-vm-tools/master/ubuntu/16.04/install.sh
wget https://raw.githubusercontent.com/Microsoft/linux-vm-tools/master/ubuntu/16.04/config-user.sh
sudo chmod +x *.sh
sudo ./install.sh
Install.sh will need to be run twice in order for the script to execute fully (it must perform a reboot mid-script). That is, once your VM reboots, you’ll need to change dir into the location of the script and run again. Once you’ve finished running the install.sh script, you’ll need to run config-user.sh
sudo ./config-user.sh
After you’ve run your scripts, shut down your VM. On your host machine in an Administrator powershell prompt, execute this command:
Set-VM -VMName <your_vm_name> -EnhancedSessionTransportType HvSocket
Start your virtual machine and connect. You will be greeted with a connection prompt windows that asks for a screen resolution--this will indicate that everything is installed correctly.
This will take you to an xorg login. This indicates that you've successfully brokered a connection and that the xrdp service is running. Login to begin your session.
NOTE: Enabling auto-login for your Ubuntu user causes an issue that will block enhanced mode from successfully connecting. Please ensure auto-login is DISABLED.