.. title:: Standard Installation Standard Installation ================================ The simplest way to deploy Kasm Workspaces is to install all application services on a single server. End-user sessions will also be provisioned on this server. All interior :term:`docker ` communication occurs within the single server and there are no special configurations required. Please read through the entire process before getting started. Troubleshooting info can be found on the :doc:`Troubleshooting Page <../guide/troubleshooting>` Issues can be reported on the `Kasm Workspaces Issues Page `_ .. 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 ` networks. Only access to the :term:`Web Application ` needs to be exposed. +----------+-----------------+------+-----------------+ | Source | Destination | Port | Notes | +----------+-----------------+------+-----------------+ | End User | Kasm Workspaces | 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 Workspaces to ``/tmp`` * Extract the package and run the installation script. .. parsed-literal:: cd /tmp curl -O |release_url| tar -xf kasm_release*.tar.gz sudo bash kasm_release/install.sh .. include:: /install/activation_key_install_note.rst .. 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/offline_install_note.rst This video walks through installing Kasm Workspaces on a single system. .. raw:: html -------------------- .. 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 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.11.0 * Remove the Kasm docker images. .. parsed-literal:: sudo docker rmi redis:5-alpine sudo docker rmi postgres:9.5-alpine sudo docker rmi kasmweb/nginx:latest sudo docker rmi kasmweb/share:|release| sudo docker rmi kasmweb/agent:|release| sudo docker rmi kasmweb/manager:|release| sudo docker rmi kasmweb/api:|release| sudo docker rmi $(sudo docker images --filter "label=com.kasmweb.image=true" -q) * Remove the Kasm installation directory structure. .. code-block:: bash sudo rm -rf /opt/kasm/