Modern VNC Server and client, web based and secure
Go to file
2021-04-20 14:51:25 -04:00
.ci CI: build all distros and upload to S3 2021-03-25 22:27:27 +13:00
builder Merge pull request #36 from kasmtech/upstreamsync_sans_novnc 2021-04-20 14:51:25 -04:00
centos Rpm: extract rpm-related install to the spec 2021-02-24 22:53:43 +13:00
cmake Run maketarball through bash 2020-09-21 13:48:54 +03:00
common Fix some local->remote clipboard merge misses 2021-04-13 13:49:43 +03:00
contrib Remove support for old Xorg versions 2020-09-21 13:25:11 +03:00
debian Deb: add example script to easily run kasmvncserver 2021-03-13 21:54:06 +13:00
doc Initial commit 2020-09-20 12:16:44 +00:00
docker Update README.md 2020-10-11 13:44:40 -04:00
kasmweb@10a7fcb91d update noVNC submodule commit 2021-04-20 09:46:01 -04:00
release Use/build ./builder/www when building tarball 2021-01-14 19:04:43 +13:00
tests Initial commit 2020-09-20 12:16:44 +00:00
unix Fix some local->remote clipboard merge misses 2021-04-13 13:49:43 +03:00
win Add support for notifying clients about pointer movements 2021-03-29 11:27:54 +03:00
.dockerignore Docker copy will ignore builder/build, where debs are 2021-02-05 23:40:44 +13:00
.gitignore Deb: add first quilt patch 2021-01-29 22:12:43 +13:00
.gitlab-ci.yml merged master in 2021-03-31 05:21:35 -04:00
.gitmodules update submodule branch 2021-04-18 06:55:26 -04:00
ACKNOWLEDGEMENTS.md [skip CI] updates to docs 2021-04-13 10:23:00 -04:00
BUILDING.txt Initial commit 2020-09-20 12:16:44 +00:00
CMakeLists.txt Bump up Windows version from Vista to Windows 7 2020-09-21 13:36:48 +03:00
config.h.in Silence clang deprecated warnings on macOS 2020-09-21 13:43:22 +03:00
LICENSE.TXT [skip CI] updates to docs 2021-04-13 10:23:00 -04:00
README.md [skip CI] Updates to install instructions 2021-04-13 11:33:30 -04:00

KasmVNC - Linux Web Remote Desktop

Kasm Technologies

Kasm Technologies LLC developed Kasm Server, a Containerized Desktop Infrastructure (CDI) solution. Kasm started with TigerVNC and eventually forked it to create KasmVNC. KasmVNC is used within the overal Kasm CDI infrastructure, however, you can use KasmVNC for individual servers. KasmVNC has different goals than TigerVNC:

  • Web-based - KasmVNC is designed to provide a web accessible remote desktop. It comes with a web server and websocket server built in. There is no need to install other components. Simply run and navigate to your desktop's URL on the port you specify. While you can still tun on the legacy VNC port, it is disabled by default.
  • Security - KasmVNC defaults to HTTPS and allows for HTTP Basic Auth. VNC Password authentication is limited by specification to 8 characters and is not suffecient for use on an internet accessible remote desktop. Our goal is to create a by default secure, web based experience.
  • Simplicity - KasmVNC aims at being simple to deploy and configure.

New Features!

  • Webp image compression for better bandwidth usage
  • Automatic mixing of webp and jpeg based on CPU availability on server
  • Multi-threaded image encoding for smoother frame rate for servers with more cores
  • Full screen video detection, goes into configurable video mode for better full screen videoo playback performance.
  • Dynamic jpeg/webp image coompression quality settings based on screen change rates
  • Seemless clipboard support (on Chromium based browsers)
  • Allow client to set/change most configuration settings
  • Data Loss Prevention features
    • Key stroke logging
    • Clipboard logging
    • Max clipboard transfer size up and down
    • Min time between clipboard operations required
    • Keyboard input rate limit
    • Screen region selection
  • Deb packages for Debian, Ubuntu, and Kali Linux included in release.
  • RPM packages for CentOS, Fedora. RPM packages are currently not updatable and not released, though you can build and install them. See build documentation.
  • Web API added for remotely controlling and getting information from KasmVNC
  • Multi-User with ability to pass control to other users.
  • Web UI uses a webpack for faster load times.
  • Network and CPU bottleneck statistics

Future Goals:

  • Support uploads and downloads
  • Pre-build Packages for all major Linux distributions

Installation

Debian-based

wget -qO- https://github.com/kasmtech/KasmVNC/releases/download/v0.9.1-beta/kasmvncserver_0.9.1~beta-1_amd64.deb

sudo dpkg -i kasmvncserver_0.9.1~beta-1_amd64.deb
sudo apt-get -f install

# We provide an example script to run KasmVNC at #
# /usr/share/doc/kasmvncserver/examples/kasmvncserver-easy-start. It runs a VNC
# server on display :10 and on interface 0.0.0.0. If you're happy with those
# defaults you can just use it as is:
sudo ln -s /usr/share/doc/kasmvncserver/examples/kasmvncserver-easy-start /usr/bin/

# Add your user to the ssl-cert group
sudo addgroup $USER ssl-cert
# You will need to re-connect in order to pick up the group change

# Create ~/.vnc directory and corresponding files.
kasmvncserver-easy-start -d && kasmvncserver-easy-start -kill

# Modify vncstartup to launch your environment of choice, in this example LXDE
# This may be optional depending on your system configuration
echo '/usr/bin/lxsession -s LXDE &' >> ~/.vnc/xstartup

# Start KasmVNC with debug logging:
kasmvncserver-easy-start -d

# Tail the logs
tail -f ~/.vnc/`hostname`:10.log

Now navigate to your system at https://[ip-address]:8443/

To stop a running KasmVNC:

kasmvncserver-easy-start -kill

The options for vncserver:

Argument Description
depth Color depth, for jpeg/webp should be 24bit
geometry Screensize, this will automatically be adjusted when the client connects.
websocketPort The port to use for the web socket. Use a high port to avoid having to run as root.
cert SSL cert to use for HTTPS
sslOnly Disable HTTP
interface Which interface to bind the web server to.

Development

Would you like to contribute to KasmVNC? Please reachout to us at info@kasmweb.com

We need help, especially in packaging KasmVNC for various operating systems. We would love to have standard debian or RMP packages and host our own repo, however, that all requires a lot of experience, proper testing, and pipeline development for automated builds.

We also need help with Windows, which is not currently supported. While KasmVNC can technically be built for Windows 10, it is unusably slow, due to all the changes that occured in Windows since the original Windows support was added in the chain of VNC forked projects.

Compiling From Source

See the builder/README.md. We containerize our build systems to ensure highly repeatable builds.

License and Acknowledgements

See the LICENSE.TXT and ACKNOWLEDGEMENTS.MD