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 7

The following instructions show how to install Docker-CE, docker compose, and OpenSSL on RedHat 7.

sudo yum install -y yum-utils device-mapper-persistent-data lvm2 nc openssl wget
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo bash -c "cat > /etc/yum.repos.d/centos-extras.repo" << EOL
[centos-extras]
name=Centos extras - $basearch
baseurl=http://mirror.centos.org/centos/7/extras/x86_64
enabled=1
gpgcheck=1
gpgkey=http://centos.org/keys/RPM-GPG-KEY-CentOS-7
EOL
sudo sed -i 's#\$releasever#7#g' /etc/yum.repos.d/docker-ce.repo
sudo yum install -y docker-ce
sudo systemctl enable --now docker.service
sudo systemctl start docker.service
sudo mkdir -p /usr/local/lib/docker/cli-plugins
sudo curl -L https://github.com/docker/compose/releases/download/v2.5.0/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/lib/docker/cli-plugins/docker-compose
sudo chmod +x /usr/local/lib/docker/cli-plugins/docker-compose

The system is now prepared for installing Kasm Workspaces. Follow the documentation for installing and configuring Kasm Workspaces.

RedHat 8/9

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

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
sudo systemctl start docker

The system is now prepared for installing Kasm Workspaces. Follow the documentation for installing and configuring Kasm Workspaces.

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

This will enable the ability to map Cloud storage providers into Workspaces sessions.

RHEL 7/8/9 (assuming Docker/Compose is already installed)

export DOCKER_PLUGIN_DIR=$(sudo docker info | awk -F': ' '/Docker Root Dir/ {print $2}')-plugins
sudo yum install -y fuse
sudo mkdir -p ${DOCKER_PLUGIN_DIR}/rclone/config
sudo mkdir -p ${DOCKER_PLUGIN_DIR}/rclone/cache
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

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.