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

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

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

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

.. code-block:: 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.

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