---
myst:
html_meta:
"description lang=en": "Kasm Workspaces can be installed on almost any Linux Distribution with Docker and Docker Compose. These instructions detail how to install the needed dependencies and deploy Kasm Workspaces on an unsupported distribution."
"keywords": "Kasm, How to, How-to, Linux, Arch, RedHat, Alpine, Installation, Workspaces, Other"
"property=og:locale": "en_US"
---
```{title} Other Operating Systems
```
# Other Operating Systems
The officially supported operating systems that Kasm Workspaces can be installed on can be found on the {doc}`System Requirements page <../install/system_requirements>` . 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.
```bash
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 {doc}`documentation <../install/single_server_install>` 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.
```bash
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 {doc}`documentation <../install/single_server_install>` 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](../guide/storage_mappings.md) 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](../guide/webcam_passthrough.md) 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.