Single Server 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 docker communication occurs within the single server and there are no special configurations required.
Please read through the entire process before getting started.
For help please see Help and Support.
Ports and Protocols
In the Single Server configurations all services communicate via internal docker networks. Only access to the Web Application and port 3389 for RDP gateway access (if desired) needs to be exposed.
| Source | Destination | Port | Notes |
|---|---|---|---|
| End User | Kasm Workspaces | 443 | Web Application |
| End User | Kasm RDP Gateway | 3389 | RDP Thick Client Access |
Installation Guide
Please review the System Requirements before beginning.
Kasm provides a Sizing and Deployment Guide to aid in determining hardware specifications for large scale deployments.
- Download the latest version of Kasm Workspaces to
/tmp - Extract the package and run the installation script.
Install Files
| Contents | URL | SHA256 |
|---|---|---|
| Installer Bundle | https://kasm-static-content.s3.amazonaws.com/kasm_release_1.17.0.7f020d.tar.gz | 22a293ea52b2adb7f3f72a2de8e9be799f443b9da040e066df403478da77f62d |
| Contents | URL | SHA256 |
|---|---|---|
| Services | https://kasm-static-content.s3.amazonaws.com/kasm_release_service_images_amd64_1.17.0.7f020d.tar.gz | 325229ed79d957d15d42cd80d75c3e59766d8953df49810fa42f09db34660a86 |
| Workspaces | https://kasm-static-content.s3.amazonaws.com/kasm_release_workspace_images_amd64_1.17.0.7f020d.tar.gz | 647a2c9a8113588c592a1d6f8b7017ac747d50f3179394912b3f6b5ab645120b |
| Network Plugin | https://kasm-static-content.s3.amazonaws.com/kasm_release_network_plugin_images_amd64_1.18.0.38f52f.tar.gz | 5e93c17b7906aa66cc0164aa3055a46561d8e1d90d3b8975363b819db17adbe5 |
| Logging Plugin | https://kasm-static-content.s3.amazonaws.com/kasm_release_logging_plugin_images_amd64_1.18.0.38f52f.tar.gz | 7bce430646270b6d3679cc8b1f2bf836bab1c0b96ec5625d524d20b1d7afb25a |
| Contents | URL | SHA256 |
|---|---|---|
| Services | https://kasm-static-content.s3.amazonaws.com/kasm_release_service_images_arm64_1.17.0.7f020d.tar.gz | 01c1936685552836f126b5be8f3480e22b5187fd008b2266f60f2722569fa38d |
| Workspaces | https://kasm-static-content.s3.amazonaws.com/kasm_release_workspace_images_arm64_1.17.0.7f020d.tar.gz | 08df2344b95af83f5d06ddc9f4f3c772e50618b2de7dcedd2016bddfaa9b70c9 |
| Network Plugin | https://kasm-static-content.s3.amazonaws.com/kasm_release_network_plugin_images_arm64_1.18.0.38f52f.tar.gz | 6f90fd9392788673ec903cedd01209d4b1245ce31113de18c9b5834379774677 |
| Logging Plugin | https://kasm-static-content.s3.amazonaws.com/kasm_release_logging_plugin_images_arm64_1.18.0.38f52f.tar.gz | 8b9e70e00de4c1c2f45b53df74c9034523542e1773921a1f2964b963e54ceb6b |
- Standard Install
- Offline Install x86-64
- Offline Install arm64
cd /tmp
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_1.17.0.7f020d.tar.gz
tar -xf kasm_release_1.17.0.7f020d.tar.gz
sudo bash kasm_release/install.sh
cd /tmp
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_1.17.0.7f020d.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_service_images_amd64_1.17.0.7f020d.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_workspace_images_amd64_1.17.0.7f020d.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_network_plugin_images_amd64_1.18.0.38f52f.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_logging_plugin_images_amd64_1.18.0.38f52f.tar.gz
tar -xf kasm_release_1.17.0.7f020d.tar.gz
sudo bash kasm_release/install.sh --offline-workspaces /tmp/kasm_release_workspace_images_amd64_1.17.0.7f020d.tar.gz --offline-service /tmp/kasm_release_service_images_amd64_1.17.0.7f020d.tar.gz --offline-network-plugin /tmp/kasm_release_network_plugin_images_amd64_1.18.0.38f52f.tar.gz --offline-logger-plugin /tmp/kasm_release_logging_plugin_images_amd64_1.18.0.38f52f.tar.gz
cd /tmp
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_1.17.0.7f020d.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_service_images_arm64_1.17.0.7f020d.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_workspace_images_arm64_1.17.0.7f020d.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_network_plugin_images_arm64_1.18.0.38f52f.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_logging_plugin_images_arm64_1.18.0.38f52f.tar.gz
tar -xf kasm_release_1.17.0.7f020d.tar.gz
sudo bash kasm_release/install.sh --offline-workspaces /tmp/kasm_release_workspace_images_arm64_1.17.0.7f020d.tar.gz --offline-service /tmp/kasm_release_service_images_arm64_1.17.0.7f020d.tar.gz --offline-network-plugin /tmp/kasm_release_network_plugin_images_arm64_1.18.0.38f52f.tar.gz --offline-logger-plugin /tmp/kasm_release_logging_plugin_images_arm64_1.18.0.38f52f.tar.gz
- Log into the Web Application running on port 443 at https://<WEBAPP_SERVER>
- The Default usernames are admin@kasm.local and user@kasm.local. The passwords will be randomly generated and presented at the end of the install unless the
--admin-passwordor/and--user-passwordare specified.
Licensing the server during install?
If you have an activation key it can be passed to the installation script and activation will be completed on your behalf as part of the install.
Create a file for the activation key e.g. activation_key.txt and paste in the activation key you received in you confirmation email.
When running the install.sh use the parameter -a or --activation-key-file so your command might look something like this sudo bash kasm_release/install.sh -a activation_key.txt.
This will not work with an offline air-gapped install, as Kasm Workspaces must contact an activation server to complete licensing your installation.
In a multi server install this option only applies to the database role.
Need to install Kasm on a different port?
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
Install Video Tutorial
This video walks through installing Kasm Workspaces on a single system.
Install troubleshooting
The install.sh script creates a log file as it runs, this file is removed upon completion of a successful installation.
However, if something does go wrong the logfile will be available from the directory the install.sh script was executed
from in the format kasm_install_${TIMESTAMP}.log. This file will be important for diagnosing the error that caused
the installation to fail and will be requested when submitting a support ticket with Kasm Technologies.
Kasm Technologies.