.. title:: Frequently Asked Questions Frequently Asked Questions ========================== .. dropdown:: I have a question or issue that isn't covered in the frequently asked questions where else can I get help? :animate: fade-in We have several options for support with the Kasm community. * Our public issue tracker on `GitHub `_. * Our `r/kasmweb subreddit `_. * Our `YouTube channel `_. * Our `support for paid customers `_. Licensing --------- .. dropdown:: Which version of Kasm Workspaces is right for me? :animate: fade-in We have a detailed page on all editions and license tiers for Kasm Workspaces here: :doc:`license information <../license>`. Kasm Workspaces Installation / Setup ------------------------------------ .. dropdown:: How is Kasm Workspaces hosted? :animate: fade-in There are several options for hosting Kasm Workspaces: * You can self-host Kasm Workspaces on a server at your residence or business * We have guides for :doc:`single server installation <../install/single_server_install>` and :doc:`multiple server installation <../install/multi_server_install>`. * You can setup Kasm Workspaces on a cloud service of your choice. * You can follow the above guides for single or multiple server installation on the cloud instances you provision. * Kasm Technologies has available in the Digital Ocean marketplace a droplet `1-click installer `_ that will create a Digital Ocean hosted Kasm Workspaces instance. * Individuals looking for a managed service can use Kasm Cloud Personal. * https://www.kasmweb.com/kasm_cloud_personal.html * Businesses looking for a managed service can contact us for Kasm Workspaces Cloud SaaS options. .. dropdown:: What are the system requirements and how do I optimize the performance of Kasm Workspaces? :animate: fade-in The basic system requirements are listed in the installation guide: :doc:`system requirements <../install/system_requirements>`. In addition for a more complex deployment we have a :doc:`system sizing and deployment guide <../how_to/sizing_operations>`. .. dropdown:: Does Kasm Workspaces support Ansible or Terraform? :animate: fade-in Kasm Workspaces supports both Ansible and Terraform: * For our Ansible documentation and example scripts visit our `Ansible GitHub repo `_. * For our Terraform documentation and example scripts visit our `Terraform GitHub repo `_. .. dropdown:: The default installation has more images than I need/want, can I customize the set of images installed? :animate: fade-in There are two options for customizing the image set at installation time. * There is a -I or --no-images option for install.sh that will instruct the installer to not pre seed any default Kasm Workspaces images. * After extracting the installation zip, but before running the install.sh, you can edit “kasm_release/conf/database/seed_data/default_images_amd64.yaml” or “kasm_release/conf/database/seed_data/default_images_arm64.yaml” depending on the architecture of the host you are installing on. Editing these files will allow you to customize the set of images that are installed during Kasm Workspaces installation. .. dropdown:: How can I ensure that my Kasm Workspaces default images are up to date? :animate: fade-in Kasm Technologies publishes new images with every Kasm workspaces release, but the team also publishes daily "rolling" images that have program and security updates. * By default Kasm Workspaces installs the static release tagged images, but by specifying -O or --use-rolling-images option Kasm Workspaces will install the rolling daily updated images. * If your Kasm Workspaces instance is already installed '-rolling' can be appending to the tag of any default Kasm Workspaces image to get the latest program and security updates. * Check out :ref:`rolling-images` for more information .. note:: In order to use the '-rolling' tag you Kasm Workspaces installation must be internet connected in order to pull down image updates. Kasm Workspaces Configuration ----------------------------- .. dropdown:: The admin account is locked, how do I reset the password? :animate: fade-in On a self-hosted deployment you can use our :doc:`admin account recovery instructions <../how_to/admin_account_recovery>` to unlock the account and set a new password. On a Kasm Technologies managed SaaS deployment, please contact our support team for assistance `support for paid customers `_. .. dropdown:: Can I install my own software or customize my desktops? :animate: fade-in Check out our page on :doc:`creating custom Kasm images <../how_to/building_images>` and :doc:`maintaining custom Kasm images <../how_to/image_maintenance>`. .. dropdown:: I need to run my image as root. :animate: fade-in If you are looking for a way to install additional software or change settings on the image please check out *Can I install my own software or customize my desktops* above. If you are looking to enable root permissions because they are required for an application to run correctly this is possible, however, it does carry security implications and should be avoided if possible. * Documentation on running a container as the :doc:`root user <../how_to/running_as_root>`. .. dropdown:: How can I keep my profile data between Kasm sessions? :animate: fade-in We have a guide on enabling a :doc:`persistent profile (home directory) <../how_to/persistent_profiles>`. .. dropdown:: I have an app that requires persistent data between Kasm sessions, or I want to be able to have a common share for all users mapped into a Kasm session. :animate: fade-in There is a guide on enabling :doc:`persistent data <../how_to/volume_mapping>` .. dropdown:: My Kasm session is torn down too quickly when idle, how can I set the session timeout to be longer? :animate: fade-in The default timeouts can be changed on the workspaces based upon the user’s :doc:`group setting <../guide/groups/group_settings>` Here is a video clip that walks through the setting changes `group settings video `_. .. dropdown:: I'd like to run a Windows or Mac OSX image in Kasm Workspaces. :animate: fade-in Windows containers do not support graphical programs such as a browser or desktop. Apple does not provide any official OSX containers. Using Kasm Workspaces --------------------- .. dropdown:: When I am browsing the internet on my computer is there an easy way to open a link inside a Kasm session? :animate: fade-in Kasm Technologies provides a browser extension that enables a right click menu for opening a link inside a Kasm session. * For the `Chrome extension `_. * For the `Firefox extension `_. * Check out our documentation for how to install and configure the :doc:`browser extensions <../how_to/kasm_extension>`. * Video demonstrating the browser extensions: https://youtu.be/U7e-mcJdZok?t=594 .. dropdown:: Do you have a developer API? :animate: fade-in We do have a developer api available, more information is available :doc:`here <../developers/developer_api>`.