Hypervnc Install Guide

Installing Docker

To start using Hypervnc we need to install Docker Engine.

First time setup

macOS

• Download and install Docker Desktop from https://www.docker.com/products/docker-desktop
  • If you already have Docker installed, make sure you are running the latest version, click Check for Updates from the Docker app next to your Wifi/Clock icons.
• Install macOS package manager Homebrew from https://brew.sh
  • To install Homebrew just need to run the following command in your macOS terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

Use Homebrew To Install Apps

Install Pulseaudio server

Pulseaudio allow us to hear sound from within the Hypervnc Docker session. To install Pulseaudio run the following command in your macOS terminal:

brew install pulseaudio

Linux

We will install Docker for Ubuntu, if you have other Linux Distributions please follow the official Docker docs at https://docs.docker.com/engine/install/

• Uninstall old versions of Docker Engine if any:

sudo apt-get remove docker docker-engine docker.io containerd runc

• Update the apt package index and install packages to allow apt to use a repository over HTTPS:

sudo apt-get update

sudo apt-get install \

apt-transport-https \

ca-certificates \

curl \

gnupg-agent \

software-properties-common

• Add Docker’s official GPG key:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

• Use the following command to set up the stable Docker repository:

sudo add-apt-repository \

"deb [arch=amd64] https://download.docker.com/linux/ubuntu \

$(lsb_release -cs) \

stable"

• Since we just added a new apt repository we will need to update the apt package index again, and install the latest version of Docker Engine and containerd:

sudo apt-get update

sudo apt-get install docker-ce docker-ce-cli containerd.io

Using the Hypervnc service

At this point we should have a working Docker Engine. Head to Hypervnc User Guide to start using the service.