Skip to content
This repository was archived by the owner on Jan 29, 2021. It is now read-only.

Onboarding: Ubuntu

Craig Wilhite edited this page Jul 31, 2018 · 20 revisions

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.

Prerequisites

You need to be on Windows 10 April 2018 update (1803) or later.

Set up an Enhanced Session Mode Linux VM

From a clean install of an Ubuntu 18.04 image, issue the following commands in a terminal:

sudo apt-get install curl
sudo curl -O 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 a 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. connect window prompt

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.

xorg login

Clone this wiki locally