.. title:: Standard Installation

Standard Installation
================================

This simplest way to install Kasms Server s to install all application services on a single server. End-user
:term:`Kasms <Kasm>` will also be provisioned on this server. All interior :term:`docker <Docker>` communication occurs within the single
server and there are no special configurations required.

.. figure:: /images/single_install/single_install2.png
  :width: 100%
  :align: center

  **Single Server Architecture**

Ports and Protocols
-----------------------
In the Single Server configurations all services communicate via internal :term:`docker <Docker>` networks. Only access to the :term:`Web Application <Web Application>` needs to be exposed.

+----------+-------------+------+-----------------+
| Source   | Destination | Port | Notes           |
+----------+-------------+------+-----------------+
| End User | Kasm Server | 443  | Web Application |
+----------+-------------+------+-----------------+


System Requirements
-------------------

Please review the :doc:`System Requirements <../install/system_requirements>`  before beginning.

.. include:: /install/swap_warning.rst

Installation Guide
--------------------------

* Download the latest version of Kasm Server to ``/tmp``

* Extract the package and run the installation script.

.. code-block:: bash

  cd /tmp
  tar -xf kasm_release*.tar.gz
  sudo bash kasm_release/install.sh

.. note::
    If you would like to run the Web Application on a different port pass the **-L** flag when calling the installer.
    e.g ``sudo bash kasm_release/install.sh -L 8443``

.. include:: /install/default_login.rst
    :start-line: 2


Uninstall
---------

* Stop All Kasm services.

.. code-block:: bash

  sudo /opt/kasm/current/bin/stop


* Remove any Kasm user session containers.

.. code-block:: bash

  sudo docker rm -f $(sudo docker container ls -qa --filter="label=kasm.kasmid")


* Remove Kasm service containers.

.. code-block:: bash

  export KASM_UID=$(id kasm -u)
  export KASM_GID=$(id kasm -g)
  sudo -E docker-compose -f /opt/kasm/current/docker/docker-compose.yaml rm


* Remove the Kasm docker network.

.. code-block:: bash

  sudo docker network rm kasm_default_network


* Remove the Kasm database docker volume.

.. parsed-literal::

  sudo docker volume rm kasm_db_1.8.0


* Remove the Kasm docker images.

.. parsed-literal::

  sudo docker rmi redis:5-alpine
  sudo docker rmi postgres:9.5-alpine
  sudo docker rmi nginx:alpine
  sudo docker rmi kasmweb/tor-browser:|release|
  sudo docker rmi kasmweb/desktop-deluxe:|release|
  sudo docker rmi kasmweb/chrome:|release|
  sudo docker rmi kasmweb/firefox:|release|
  sudo docker rmi kasmweb/desktop:|release|
  sudo docker rmi kasmweb/share:|release|
  sudo docker rmi kasmweb/agent:|release|
  sudo docker rmi kasmweb/manager:|release|
  sudo docker rmi kasmweb/api:|release|


* Remove the Kasm installation directory structure.

.. code-block:: bash

  sudo rm -rf /opt/kasm/