Getting Started

Kasm Workspaces provides browser-based access to on-demand containerized desktops and applications.

General information about the Workspaces platform is available at https://kasmweb.com

Help and Support Resources

There is a wealth of self-help, guided and community resources available should you get stuck.

• Frequently Asked Questions - Please see our FAQ for commonly questions.

• Troubleshooting Guide - The troubleshooting guide may be able to help with common connectivity and configuration items.

• YouTube Instructional Videos - We have a library of helpful video tutorials for admins and end users alike.

• Community Issue Tracker - Search for issues reported by others or submit your own feature request / bug report.

• Reddit - Join our community to discuss use-cases, questions, and related technology.

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 needs to be exposed.

Source	Destination	Port	Notes
End User	Kasm Workspaces	443	Web Application

Installation Guide

Please review the System Requirements before beginning.

• Download the latest version of Kasm Workspaces to /tmp

• Extract the package and run the installation script.

Standard InstallOffline Install x86-64Offline Install arm64

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

• 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

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.