```{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 <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](https://github.com/kasmtech/workspaces-issues/issues)

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

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

```{eval-rst}
+----------+-----------------+------+-----------------+
| 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.md
```

## 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.md
```

```{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.md
```

This video walks through installing Kasm Workspaces on a single system.

```{raw} html
<iframe width="560" height="315" src="https://www.youtube.com/embed/QV6CcV9eNNs" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
```

______________________________________________________________________

```{include} /install/default_login.md
```

## Uninstall

- Stop All Kasm services.

```bash
sudo /opt/kasm/current/bin/stop
```

- Remove any Kasm session containers.

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

- Remove Kasm service containers.

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

```bash
sudo docker network rm kasm_default_network
```

- Remove the Kasm database docker volume.

```{eval-rst}
.. 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.

```bash
sudo rm -rf /opt/kasm/
```


- Remove the Kasm User Accounts.

```bash
sudo deluser kasm_db
sudo deluser kasm
```