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.

Single Server Architecture

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.

tip

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.18.0.09f70a.tar.gz	056754c1378f7d10868847e8308216f1ce32f9b585008875c6e8bb58737e29ab

Contents	URL	SHA256
Services	https://kasm-static-content.s3.amazonaws.com/kasm_release_service_images_amd64_1.18.0.09f70a.tar.gz	841b2d9b78e4629fce2dafcf76b4723a7edd450a74240227b04fabf406d60690
Workspaces	https://kasm-static-content.s3.amazonaws.com/kasm_release_workspace_images_amd64_1.18.0.09f70a.tar.gz	24c6d9b1b7c852cfd7614ce4fbfecfaacdb5b8d303f554603fbd0322d3c31a0b
Network Plugin	https://kasm-static-content.s3.amazonaws.com/kasm_release_network_plugin_images_amd64_1.18.0.09f70a.tar.gz	5e93c17b7906aa66cc0164aa3055a46561d8e1d90d3b8975363b819db17adbe5
Logging Plugin	https://kasm-static-content.s3.amazonaws.com/kasm_release_logging_plugin_images_amd64_1.18.0.09f70a.tar.gz	7bce430646270b6d3679cc8b1f2bf836bab1c0b96ec5625d524d20b1d7afb25a

Contents	URL	SHA256
Services	https://kasm-static-content.s3.amazonaws.com/kasm_release_service_images_arm64_1.18.0.09f70a.tar.gz	d077302567c6477aba31b1e91983ed320395a06611d48add19b1609d3025119e
Workspaces	https://kasm-static-content.s3.amazonaws.com/kasm_release_workspace_images_arm64_1.18.0.09f70a.tar.gz	9ab25cabe26b9d1883a869402d5601df2c3f4106091b06057f5ccd1767e619cb
Network Plugin	https://kasm-static-content.s3.amazonaws.com/kasm_release_network_plugin_images_arm64_1.18.0.09f70a.tar.gz	6f90fd9392788673ec903cedd01209d4b1245ce31113de18c9b5834379774677
Logging Plugin	https://kasm-static-content.s3.amazonaws.com/kasm_release_logging_plugin_images_arm64_1.18.0.09f70a.tar.gz	8b9e70e00de4c1c2f45b53df74c9034523542e1773921a1f2964b963e54ceb6b

Standard Install

cd /tmp
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_1.18.0.09f70a.tar.gz
tar -xf kasm_release_1.18.0.09f70a.tar.gz
sudo bash kasm_release/install.sh

Offline Install x86-64

cd /tmp
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_1.18.0.09f70a.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_service_images_amd64_1.18.0.09f70a.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_workspace_images_amd64_1.18.0.09f70a.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_network_plugin_images_amd64_1.18.0.09f70a.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_logging_plugin_images_amd64_1.18.0.09f70a.tar.gz
tar -xf kasm_release_1.18.0.09f70a.tar.gz
sudo bash kasm_release/install.sh --offline-workspaces /tmp/kasm_release_workspace_images_amd64_1.18.0.09f70a.tar.gz --offline-service /tmp/kasm_release_service_images_amd64_1.18.0.09f70a.tar.gz --offline-network-plugin /tmp/kasm_release_network_plugin_images_amd64_1.18.0.09f70a.tar.gz --offline-logger-plugin /tmp/kasm_release_logging_plugin_images_amd64_1.18.0.09f70a.tar.gz

Offline Install arm64

cd /tmp
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_1.18.0.09f70a.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_service_images_arm64_1.18.0.09f70a.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_workspace_images_arm64_1.18.0.09f70a.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_network_plugin_images_arm64_1.18.0.09f70a.tar.gz
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_logging_plugin_images_arm64_1.18.0.09f70a.tar.gz
tar -xf kasm_release_1.18.0.09f70a.tar.gz
sudo bash kasm_release/install.sh --offline-workspaces /tmp/kasm_release_workspace_images_arm64_1.18.0.09f70a.tar.gz --offline-service /tmp/kasm_release_service_images_arm64_1.18.0.09f70a.tar.gz --offline-network-plugin /tmp/kasm_release_network_plugin_images_arm64_1.18.0.09f70a.tar.gz --offline-logger-plugin /tmp/kasm_release_logging_plugin_images_arm64_1.18.0.09f70a.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-password or/and --user-password are specified.

Default Login Window

Licensing the server during install?

Note

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?

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

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.