--- 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.