diff options
| author | Tim Edwards <liststuff@fastmail.com.au> | 2019-07-26 06:22:48 +1000 |
|---|---|---|
| committer | Samuel Mannehed <samuel@cendio.se> | 2019-07-25 22:22:48 +0200 |
| commit | e1d50c8c10563edcacebcaeb32d022906aa003d2 (patch) | |
| tree | 53cb42a84a3387f463df59fdd3affff608fa0c7a /README.md | |
| parent | 897b465b870eddefb8bc7305cba514139cc1ca32 (diff) | |
| download | novnc-e1d50c8c10563edcacebcaeb32d022906aa003d2.tar.gz | |
Added a Snap package for noVNC (#1231)
Creating an Ubuntu Snap package to make noVNC easier to deploy.
Checks for the websockify binary in both the PATH (using which) and in the location where the Snap package places the binary. This is necessary for noVNC to be usable in a Snap. It doesn't affect the original functionality of git cloning websockify if it's not found in PATH or the Snap location.
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 61 |
1 files changed, 61 insertions, 0 deletions
@@ -24,6 +24,7 @@ for a more complete list with additional info and links. - [Browser Requirements](#browser-requirements) - [Server Requirements](#server-requirements) - [Quick Start](#quick-start) +- [Installation from Snap Package](#installation-from-snap-package) - [Integration and Deployment](#integration-and-deployment) - [Authors/Contributors](#authorscontributors) @@ -115,6 +116,66 @@ proxy. script. Hit the Connect button, enter a password if the VNC server has one configured, and enjoy! +### Installation from Snap Package +Running the command below will install the latest release of noVNC from Snap: + +`sudo snap install novnc` + +#### Running noVNC + +You can run the Snap-package installed novnc directly with, for example: + +`novnc --listen 6081 --vnc localhost:5901 # /snap/bin/novnc if /snap/bin is not in your PATH` + +#### Running as a Service (Daemon) +The Snap package also has the capability to run a 'novnc' service which can be +configured to listen on multiple ports connecting to multiple VNC servers +(effectively a service runing multiple instances of novnc). +Instructions (with example values): + +List current services (out-of-box this will be blank): + +``` +sudo snap get novnc services +Key Value +services.n6080 {...} +services.n6081 {...} +``` + +Create a new service that listens on port 6082 and connects to the VNC server +running on port 5902 on localhost: + +`sudo snap set novnc services.n6082.listen=6082 services.n6082.vnc=localhost:5902` + +(Any services you define with 'snap set' will be automatically started) +Note that the name of the service, 'n6082' in this example, can be anything +as long as it doesn't start with a number or contain spaces/special characters. + +View the configuration of the service just created: + +``` +sudo snap get novnc services.n6082 +Key Value +services.n6082.listen 6082 +services.n6082.vnc localhost:5902 +``` + +Disable a service (note that because of a limitation in Snap it's currently not +possible to unset config variables, setting them to blank values is the way +to disable a service): + +`sudo snap set novnc services.n6082.listen='' services.n6082.vnc=''` + +(Any services you set to blank with 'snap set' like this will be automatically stopped) + +Verify that the service is disabled (blank values): + +``` +sudo snap get novnc services.n6082 +Key Value +services.n6082.listen +services.n6082.vnc +``` ### Integration and Deployment |