You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[Kasm](https://www.kasmweb.com/?utm_campaign=LinuxServer&utm_source=listing) Workspaces is a docker container streaming platform for delivering browser-based access to desktops, applications, and web services. Kasm uses devops-enabled Containerized Desktop Infrastructure (CDI) to create on-demand, disposable, docker containers that are accessible via web browser. Example use-cases include Remote Browser Isolation (RBI), Data Loss Prevention (DLP), Desktop as a Service (DaaS), Secure Remote Access Services (RAS), and Open Source Intelligence (OSINT) collections.
26
25
@@ -56,25 +55,27 @@ Access the installation wizard at https://`your ip`:3000 and follow the instruct
56
55
57
56
Currently Synology systems are not supported due to them blocking CPU scheduling in their Kernel.
58
57
59
-
### Updating KASM
58
+
### Upgrading KASM
60
59
61
-
In order to update kasm, first make sure you are using the latest docker image, and then perform the in app update in the admin panel. Docker image update and recreation of container alone won't update kasm.
60
+
In order to upgrade Kasm, first make sure you are using the latest docker image, and then perform the in app update from the installation wizard. Docker image update and recreation of container alone won't upgrade Kasm.
61
+
62
+
Following the upgrade, you will need to update any workspace image tags to match the new version.
62
63
63
64
### GPU Support
64
65
65
-
During installation an option will be presented to force all Workspace containers to mount in and use a specific GPU. If using an NVIDIA GPU you will need to pass `-e NVIDIA_VISIBLE_DEVICES=all` or `--gpus all` and have the [NVIDIA Container Runtime](https://github.com/NVIDIA/nvidia-container-runtime) installed on the host. Also if using NVIDIA, Kasm Workspaces has [native NVIDIA support](https://www.kasmweb.com/docs/latest/how_to/gpu.html) so you can optionally opt to simply use that instead of he manual override during installation.
66
+
During installation an option will be presented to force all Workspace containers to mount in and use a specific GPU. If using an NVIDIA GPU you will need to pass `-e NVIDIA_VISIBLE_DEVICES=all` or `--gpus all` and have the [NVIDIA Container Toolkit](https://github.com/NVIDIA/nvidia-container-toolkit) installed on the host. Also if using NVIDIA, Kasm Workspaces has [native NVIDIA support](https://docs.kasm.com/docs/latest/how-to/gpu/index.html) so you can optionally opt to simply use that instead of he manual override during installation.
66
67
67
68
### Gamepad support
68
69
69
-
In order to properly create virtual Gamepads you will need to mount from your host `/dev/input` and `/run/udev/data`. Please see [HERE](https://www.kasmweb.com/docs/develop/guide/gamepad_passthrough.html) for instructions on enabling gamepad support.
70
+
In order to properly create virtual Gamepads you will need to mount from your host `/dev/input` and `/run/udev/data`. Please see [HERE](https://docs.kasm.com/docs/latest/guide/gamepad_passthrough/index.html) for instructions on enabling gamepad support.
70
71
71
72
### Persistant profiles
72
73
73
-
In order to use persistant profiles in Workspaces you will need to mount in a folder to use from your host to `/profiles`. From there when configuring a workspace you can set the `Persistant Profile Path` to IE `/profiles/ubuntu-focal/{username}/`, more infomation can be found [HERE](https://www.kasmweb.com/docs/latest/how_to/persistent_profiles.html).
74
+
In order to use persistant profiles in Workspaces you will need to mount in a folder to use from your host to `/profiles`. From there when configuring a workspace you can set the `Persistant Profile Path` to IE `/profiles/ubuntu-focal/{username}/`, more infomation can be found [HERE](https://docs.kasm.com/docs/latest/guide/persistent_data/persistent_profiles).
74
75
75
76
### Reverse proxy
76
77
77
-
A sample for [SWAG](https://github.com/linuxserver/docker-swag) can be found [here](https://raw.githubusercontent.com/linuxserver/reverse-proxy-confs/master/kasm.subdomain.conf.sample). Post installation you will need to modify the "Proxy Port" setting under the default zone to 0 as outlined [here](https://www.kasmweb.com/docs/latest/how_to/reverse_proxy.html#update-zones) to launch Workspaces sessions.
78
+
A sample for [SWAG](https://github.com/linuxserver/docker-swag) can be found [here](https://raw.githubusercontent.com/linuxserver/reverse-proxy-confs/master/kasm.subdomain.conf.sample). Post installation you will need to modify the "Proxy Port" setting under the default zone to 0 as outlined [here](https://docs.kasm.com/docs/latest/how-to/reverse_proxy/index.html#update-zones) to launch Workspaces sessions.
78
79
79
80
### Strict reverse proxies
80
81
@@ -113,6 +114,7 @@ services:
113
114
ports:
114
115
- 3000:3000
115
116
- 443:443
117
+
stop_grace_period: "90s"#optional
116
118
restart: unless-stopped
117
119
```
118
120
@@ -133,6 +135,7 @@ docker run -d \
133
135
-v /path/to/kasm/profiles:/profiles `#optional` \
134
136
-v /dev/input:/dev/input `#optional` \
135
137
-v /run/udev/data:/run/udev/data `#optional` \
138
+
--stop-timeout="90s" `#optional` \
136
139
--restart unless-stopped \
137
140
lscr.io/linuxserver/kasm:latest
138
141
```
@@ -170,6 +173,7 @@ Containers are configured using parameters passed at runtime (such as those abov
170
173
171
174
| Parameter | Function |
172
175
| :-----: | --- |
176
+
|`--stop-timeout=`| Increase container shutdown delay to give Kasm services time to stop cleanly. |
173
177
|`--security-opt apparmor=rootlesskit`| Some hosts require this on top of privileged for namespacing to work properly inside the DinD layer. |
174
178
175
179
## Environment variables from files (Docker secrets)
@@ -352,11 +356,11 @@ To help with development, we generate this dependency graph.
352
356
init-custom-files -> init-services
353
357
init-services -> svc-cron
354
358
svc-cron -> legacy-services
355
-
init-config-kasm -> svc-docker
356
359
init-services -> svc-docker
357
360
svc-docker -> legacy-services
358
-
init-config-kasm -> svc-kasm-wizard
359
-
init-services -> svc-kasm-wizard
361
+
svc-docker -> svc-kasm
362
+
svc-kasm -> legacy-services
363
+
svc-docker -> svc-kasm-wizard
360
364
svc-kasm-wizard -> legacy-services
361
365
}
362
366
Base Images: {
@@ -367,6 +371,7 @@ To help with development, we generate this dependency graph.
367
371
368
372
## Versions
369
373
374
+
***16.04.26:** - Update for 1.18.1 release. Use rolling service images. Bump docker to v29.
370
375
***13.11.25:** - Pin docker to v28 to avoid API deprecation issues.
0 commit comments