|
2 years ago | |
---|---|---|
bin | 2 years ago | |
conf | 2 years ago | |
docker | 2 years ago | |
licenses | 2 years ago | |
www | 2 years ago | |
README.md | 2 years ago | |
install.sh | 2 years ago | |
install_dependencies.sh | 2 years ago |
README.md
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"