```{title} System Requirements
```

# Kasm Workspaces Requirements

Kasm Workspaces can be installed in a {doc}`single server <single_server_install>` or {doc}`multi server <multi_server_install>` setup.

## Operating System

Kasm Services and end user sessions are {term}`Docker` containers. Access to the Docker registry is required for
installation.

Installation is supported on the following operating systems:

```{eval-rst}
.. table:: **Supported Operating Systems**
    :widths: 100

    +-------------------------------------------------------+
    | Ubuntu 18.04 / 20.04 / 22.04 (amd64/arm64)            |
    +-------------------------------------------------------+
    | Debian 9 / 10 / 11 (amd64/arm64)                      |
    +-------------------------------------------------------+
    | CentOS 7 / 8  (amd64/arm64)                           |
    +-------------------------------------------------------+
    | Oracle Linux 7 / 8  (amd64/arm64)                     |
    +-------------------------------------------------------+
    | Raspberry Pi OS (Debian) 10 / 11 (arm64)              |
    +-------------------------------------------------------+
    | :doc:`Other <../how_to/other_operating_systems>`      |
    +-------------------------------------------------------+
```

```{note}
Not all published Workspaces Images are available on all architectures. Please see {doc}`Default Images <../guide/custom_images>` for the support matrix.
```

## Resource Requirements

```{eval-rst}
.. table:: **Minimum Requirements**
    :widths: 100,100

    +-------------+------------+
    | **CPU**     | 2 cores    |
    +-------------+------------+
    | **Memory**  |        4GB |
    +-------------+------------+
    | **Storage** | 50GB (SSD) |
    +-------------+------------+

```

```{note}
Although the requirements for the Kasm services are quite modest, provisioning each end-user session
requires additional compute resources as specified in the {term}`Image<Image>` configuration. The default Kasm
Images are {doc}`configured <../guide/custom_images>` to require 2768MB of memory and 2 cores. Sessions will not be
provisioned if the minimum resources requirements on the {term}`Agent` are not met.
```

(docker-versions)=

## Docker and Docker Compose

During the installation, the installer will install known compatible versions of {code}`docker` and
{code}`docker compose` if the programs do not already exist on the machine. However, if the programs already exist,
the installer will not replace them.

It is recommended that you install Kasm on a single-purpose machine and let the installer install the {code}`docker` and
{code}`docker compose` programs. Below are the minimum requirements.

```{eval-rst}
.. table:: **Minimum Version Requirements**
    :widths: 100,100

    +----------------------+------------+
    | **docker**           | > 18.06    |
    +----------------------+------------+
    | **docker compose**   | > 2.1.1    |
    +----------------------+------------+
```

Run the following commands to check the versions of the programs if installed.

```bash
sudo docker --version
sudo docker info | grep "Docker Compose"
```

# End User Requirements

End-users access the Kasm Workspaces via the web ui. Most modern browsers are supported.

```{eval-rst}
+--------------------------+
| **Browsers**             |
+--------------------------+
| Chrome 49+               |
+--------------------------+
| Edge 14+                 |
+--------------------------+
| Firefox 48+              |
+--------------------------+
| Internet Explorer 11 [1] |
+--------------------------+
| Safari 11+               |
+--------------------------+
```

**Caveats**

- Audio is not supported on mobile browsers.
- Seamless Clipboard ( Copying and Pasting without using the control panel ) is only supported on Chrome and Chromium-based client browsers.

\[1\] Audio Not Supported.