User Tools

Site Tools


Nova RDP Support Configuration

Nova currently provides support for VNC and SPICE graphical consoles. VNC in particular is the protocol employed natively by most popular hypervisors supported by Nova. Microsoft Hyper-V in this context is a remarkable exception, as it employs the Remote Desktop Protocol (RDP) for graphical console access, based on Open Specifications and implemented by various open source projects.

Here's an example video showing an HTML5 RDP console based on FreeRDP.

Configuring Nova for RDP support

RDP console configuration is quite straightforward. All you need to do is to add the following configuration settings in your Hyper-V compute node's nova.conf:


Where the url specified in the html5_proxy_base_url setting is provided by the FreeRDP HTML5 proxy as detailed in the next section.

Installing and configuring the FreeRDP HTML5 proxy

The FreeRDP HTML5 proxy can be installed on various Linux distributions (currently Ubuntu >= 12.04, RHEL 6.x / CentOS 6.x and Fedora >= 16) or on Microsoft Windows, including Hyper-V Server.

Ubuntu 12.04 and above

A shell script is provided to simplify the installation of the application and the dependencies, mostly available in source form only.

  sudo apt-get install -y git
  git clone
  cd FreeRDP-WebConnect    
  sudo ./ -f -i

At this point the proxy, called wsgate can be installed by running:

  sudo make install    

wsgate configuration

The default configuration file is located here:


Change the following options to match your environment configuration:

  port = 8000

Note: make sure to open the port in your operating system firewall.

  authurl =
  username = admin
  password = secret
  tenantname = admin
  # Credentials used to connect to the Hyper-V hosts when accessing
  # OpenStack instances consoles  
  hostusername = Administrator
  hostpassword = secret

It is also strongly recommended to encrypt the traffic using HTTPS. Here are the relevant parameters, including a PEM file containing both the certificate and the private key.

  port = 4430
  certfile = /usr/local/etc/wsgate/test.pem
  certpass = verysecret

HTML, CSS and Javascript files are available at the following location for further customization:


Running wsgate

wsgate can be executed as a demon with the following instruction:

  wsgate -c /usr/local/etc/wsgate.ini

In case you should prefer to execute wsgate in a shell for debugging purposes, just set:

  daemon = false
nova-rdp.txt · Last modified: 2014/06/12 19:37 (external edit)