Skip to main content
Version: Developer

Other Operating Systems

The officially supported operating systems that Kasm Workspaces can be installed on can be found on the System Requirements page . However, Workspaces can be installed on any Linux operating system with bash, openssl, Docker-CE, and docker compose pre-installed. The installation script checks if docker and docker compose are installed, if all the requirements are met the script will bypass operating system checks. Generally, this means that Workspaces can be installed on any Linux based operating system that Docker supports.

RedHat 8/9/10​

The following instructions show how to install Docker-CE, docker compose, and OpenSSL on RedHat 8, 9 or 10.

# Install dependencies
sudo yum install -y yum-utils device-mapper-persistent-data lvm2 nc openssl lsof curl
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# start docker 
sudo systemctl enable --now docker
sudo systemctl start docker

Note: Docker may fail to start due to missing kernel modules in RHEL 10, as all kernel modules related to the iptables utility have been moved to kernel-modules-extra. If you see errors like, iptables failed: addrtype not supported, missing kernel module? xt_addrtype, install the missing modules and start Docker:

sudo dnf install -y kernel-modules-extra
sudo reboot

sudo systemctl enable --now docker
sudo systemctl start docker

Optional Dependencies​

Outside of Docker and Compose, Kasm Workspaces can gain additional functionality through Docker plugins or other system packages being installed.

Rclone for Cloud Storage Mapping​

Installing the rclone docker plugin will enable the ability to map Cloud storage providers into Workspaces sessions. The following basic steps can be adapted for use on the desired target operating system.

export DOCKER_PLUGIN_DIR=$(sudo docker info | awk -F': ' '/Docker Root Dir/ {print $2}')-plugins
#install fuse. Replace this line with something appropriate for the target operating system
sudo yum install -y fuse 
mkdir -p ${DOCKER_PLUGIN_DIR}/rclone/config
sudo mkdir -p ${DOCKER_PLUGIN_DIR}/rclone/cache
# Arch is either amd64 or arm64
sudo docker plugin install rclone/docker-volume-rclone:${ARCH} args="-v" --alias rclone --grant-all-permissions
sudo rm -f ${DOCKER_PLUGIN_DIR}/rclone/cache/docker-plugin.state
sudo ln -s /dev/null ${DOCKER_PLUGIN_DIR}/rclone/cache/docker-plugin.state

v4l2loopback for Webcam support​

This will allow Webcam Passthrough for Workspaces sessions.

RHEL 8/9/10

sudo yum install -y --nogpgcheck https://dl.fedoraproject.org/pub/epel/epel-release-latest-$(rpm -E %rhel).noarch.rpm
sudo yum install -y --nogpgcheck https://mirrors.rpmfusion.org/free/el/rpmfusion-free-release-$(rpm -E %rhel).noarch.rpm https://mirrors.rpmfusion.org/nonfree/el/rpmfusion-nonfree-release-$(rpm -E %rhel).noarch.rpm
sudo yum install -y v4l2loopback

Using this method the host will be limited to 8 virtual webcam devices, keep this in mind when making deployment decisions.