Kasmweb install v1.7.0 and v1.7.0 images, including desktop-seafile image

Install instructions

git clone https://gitlab.fredhs.net/bengt/kasm_install.git kasm_install
sudo bash kasm_install\install.sh

Note

If you would like to run the Web Application on a different port pass the -L flag when calling the installer. e.g sudo bash kasm_release/install.sh -L 8443

Add own cert for webserver

Stop the Kasm Services

sudo /opt/kasm/bin/stop

Replace kasm_nginx.crt and kasm_nginx.key files

sudo cp <your_cert> /opt/kasm/current/certs/kasm_nginx.crt
sudo cp <your_key> /opt/kasm/current/certs/kasm_nginx.key

Start the Kasm Services

sudo /opt/kasm/bin/start

Example Nginx Config if you use reverse proxy

Below is an example Nginx config with the appropriate settings for Kasm annotated. In this example, Nginx is listening on port 443 and Kasm Server is listening on port 8443

Example Nginx Configuration

 server {
     listen 443 ssl;
     ssl_certificate /etc/nginx/ssl/nginx.crt;
     ssl_certificate_key /etc/nginx/ssl/nginx.key;

     location / {
         # The following configurations must be configured when proxying to Kasm Server

         # WebSocket Support
         proxy_set_header        Upgrade $http_upgrade;
         proxy_set_header        Connection "upgrade";

         # Host and X headers
         proxy_set_header        Host $host;
         proxy_set_header        X-Real-IP $remote_addr;
         proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
         proxy_set_header        X-Forwarded-Proto $scheme;

         # Connectivity Options
         proxy_http_version      1.1;
         proxy_read_timeout      1800s;
         proxy_send_timeout      1800s;
         proxy_connect_timeout   1800s;
         proxy_buffering         off;

         # Allow large requests to support file uploads to Kasms
         client_max_body_size 10M;

         # Proxy to Kasm Server running locally on 8443 using ssl
         proxy_pass https://127.0.0.1:8443 ;
     }
 }

In order for the system to properly make connections to the Kasms when they are provisioned, the proxy_port Setting needs to be updated with the port the Reverse Proxy is listening on. For example, if the reverse proxy is listening on 443 this setting must reflect that.

• Log into the Kasm Server UI as an administrator
  • Select Settings.
  • Update the proxy_port setting.
• Log into the Kasm Server Host
  • Restart the Kasm Services

  sudo /opt/kasm/bin/stop
  sudo /opt/kasm/bin/start
  

Install on Alpine Host

Install requirements:

apk add docker docker-compose bash shadow sudo findutils util-linux lsof ip6tables curl

You may, probably, encounter WARNING: No {swap,memory} limit support message by executing docker info. To correct this situation we have to enable the cgroup_enable=memory swapaccount=1

Extlinux

With Extlinux you also add the cgroup condition but inside /etc/update-extlinux.conf

default_kernel_opts="... cgroup_enable=memory swapaccount=1"

than update the config and reboot

update-extlinux

Grub

Well; if you use Grub it is like any other linux and you just have to add the cgroup condition into /etc/default/grub, then upgrade your grub

GRUB_CMDLINE_LINUX_DEFAULT="... e=memory swapaccount=1"