publicWagsHome/KasmVNC
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Revert "Update README: deb installation only"

Browse Source 
This reverts commit 213f91c1a7.
This commit is contained in:
Dmitry Maksyoma
2021-03-25 22:04:16 +13:00
parent 40facbcc46
commit ca326ee1f1
1 changed files with 19 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

42
README.md
View File

@@ -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 # modify 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 |
| -------- | ----------- | | -------- | ----------- |