@ -33,44 +33,40 @@ Future Goals:
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					  - CI pipelines to create releases
 
					 
					 
					 
					  - CI pipelines to create releases
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					
 
					 
					 
					 
					
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					### Installation
 
					 
					 
					 
					### Installation
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					 
					 
					 
					 
					We are currently developing releasable packages for major operating sytems. The install script available with releases will install dependencies, compile webp, and pull down and install the pre-compiled KasmVNC tarball. Currently, only Ubuntu 18.04 LTS is pre-compiled.
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					
 
					 
					 
					 
					
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					#### Debian-based 
 
					 
					 
					 
					This installer assumes you already have a desktop environment installed, but have never configured a VNC server. Use the install script found in this project under builder/install/install.sh, currently Ubuntu 18.04LTS is the only operating system with pre-compiled binaries. 
 
				
			 
			
				
				
			
		
	
		
		
	
		
		
			
				
					
					 
					 
					 
					
 
					 
					 
					 
					
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					```sh
 
					 
					 
					 
					```sh
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					wget -qO- https://github.com/kasmtech/KasmVNC/releases/download/v0.9.1-beta/kasmvncserver_0.9.1~beta-1_amd64.deb
 
					 
					 
					 
					# install dependencies
 
				
			 
			
				
				
			
		
	
		
		
	
		
		
			
				
					
					 
					 
					 
					 
					 
					 
					 
					sudo apt-get -y install libjpeg-dev
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					
 
					 
					 
					 
					
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					sudo dpkg -i kasmvncserver_0.9.1~beta-1_amd64.deb 
 
					 
					 
					 
					# install KasmVNC 
 
				
			 
			
				
				
			
		
	
		
		
			
				
					
					 
					 
					 
					sudo apt-get -f install 
 
					 
					 
					 
					wget -qO- https://github.com/kasmtech/KasmVNC/releases/download/v0.9.1-beta/KasmVNC_0.9.1-beta_Ubuntu_18.04.tar.gz | sudo tar xz --strip 1 -C / 
 
				
			 
			
				
				
			
		
	
		
		
	
		
		
	
		
		
			
				
					
					 
					 
					 
					
 
					 
					 
					 
					
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					# We provide an example script to run KasmVNC at #
 
					 
					 
					 
					# Generate an SSL Cert and change owner
 
				
			 
			
				
				
			
		
	
		
		
			
				
					
					 
					 
					 
					`/usr/share/doc/kasmvncserver/examples/kasmvncserver-easy-start` . It runs a VNC
 
					 
					 
					 
					sudo mkdir /usr/local/share/kasmvnc/certs
 
				
			 
			
				
				
			
		
	
		
		
			
				
					
					 
					 
					 
					# server on display `:10`  and on interface `0.0.0.0` . If you're happy with those
 
					 
					 
					 
					sudo openssl req -x509 -nodes -days 3650 -newkey rsa:2048 -keyout /usr/local/share/kasmvnc/certs/self.pem -out /usr/local/share/kasmvnc/certs/self.pem -subj "/C=US/ST=VA/L=None/O=None/OU=DoFu/CN=kasm/emailAddress=none@none.none"
 
				
			 
			
				
				
			
		
	
		
		
			
				
					
					 
					 
					 
					# defaults you can just use it as is:
 
					 
					 
					 
					sudo chown $USER /usr/local/share/kasmvnc/certs/self.pem
 
				
			 
			
				
				
			
		
	
		
		
			
				
					
					 
					 
					 
					ln -s /usr/share/doc/kasmvncserver/examples/kasmvncserver-easy-start /usr/local/bin/
 
					 
					 
					 
					 
				
			 
			
		
	
		
		
	
		
		
	
		
		
	
		
		
	
		
		
			
				
					
					 
					 
					 
					
 
					 
					 
					 
					
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					# Create ~/.vnc directory and corresponding files.
 
					 
					 
					 
					# start kasmvnc and set password for remote access
 
				
			 
			
				
				
			
		
	
		
		
			
				
					
					 
					 
					 
					kasmvncserver-easy-start -d & &  kasmvncserver-easy-start -kill
 
					 
					 
					 
					vncserver :1 -interface 0.0.0.0
 
				
			 
			
				
				
			
		
	
		
		
	
		
		
	
		
		
			
				
					
					 
					 
					 
					 
					 
					 
					 
					# stop kasmvnc to make config changes
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					 
					 
					 
					 
					vncserver -kill :1
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					
 
					 
					 
					 
					
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					# Modify vncstartup to launch your environment of choice, in this example LXDE
 
					 
					 
					 
					# m odify vncstartup to launch your environment of choice, in this example LXDE
 
				
			 
			
				
				
			
		
	
		
		
	
		
		
			
				
					
					 
					 
					 
					echo '/usr/bin/lxsession -s LXDE & ' >> ~/.vnc/xstartup
 
					 
					 
					 
					echo '/usr/bin/lxsession -s LXDE & ' >> ~/.vnc/xstartup
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					
 
					 
					 
					 
					
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					# The KasmVNC username is automatically set to your system username, you can mofify it if you wish
 
					 
					 
					 
					# The KasmVNC username is automatically set to your system username, you can mofify it if you wish
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					vi ~/.vnc/config
 
					 
					 
					 
					vi ~/.vnc/config
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					
 
					 
					 
					 
					
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					# Start KasmVNC with debug logging:
 
					 
					 
					 
					# launch KasmVNC
 
				
			 
			
				
				
			
		
	
		
		
			
				
					
					 
					 
					 
					kasmvncserver-easy-start -d
 
					 
					 
					 
					vncserver $DISPLAY -depth 24 -geometry 1280x1050 -websocketPort 8443 -cert /usr/local/share/kasmvnc/certs/self.pem -sslOnly -FrameRate=24 -interface 0.0.0.0
 
				
			 
			
				
				
			
		
	
		
		
			
				
					
					 
					 
					 
					tail -f ~/.vnc/`hostname`:10.log
 
					 
					 
					 
					 
				
			 
			
		
	
		
		
	
		
		
	
		
		
			
				
					
					 
					 
					 
					```
 
					 
					 
					 
					```
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					
 
					 
					 
					 
					
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					Now navigate to your system at https://[ip-address]:8443/
 
					 
					 
					 
					Now navigate to your system at https://[ip-address]:8443/vnc.html 
 
				
			 
			
				
				
			
		
	
		
		
	
		
		
			
				
					
					 
					 
					 
					
 
					 
					 
					 
					
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					To stop a running KasmVNC:
 
					 
					 
					 
					The options for vncserver in the example above:
 
				
			 
			
				
				
			
		
	
		
		
			
				
					
					 
					 
					 
					
 
					 
					 
					 
					 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					```sh
 
					 
					 
					 
					 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					kasmvncserver-easy-start -kill
 
					 
					 
					 
					 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					```
 
					 
					 
					 
					 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					
 
					 
					 
					 
					 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					The options for vncserver:
 
					 
					 
					 
					 
				
			 
			
		
	
		
		
	
		
		
			
				
					
					 
					 
					 
					
 
					 
					 
					 
					
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					| Argument | Description |
 
					 
					 
					 
					| Argument | Description |
 
				
			 
			
		
	
		
		
			
				
					
					 
					 
					 
					| -------- | ----------- |
 
					 
					 
					 
					| -------- | ----------- |