Skip to main content
Version: Developer

Server Settings

Server settings are settings that are global, as opposed to those that are per user group. They can be found in the Settings tab on the left side of the Administrative Web UI. In most cases, a change to a global setting requires a restart of some or all components. For a single server environment that would mean just restarting the kasm services on the server. For distributed environments you may only need to restart certain components. The tables below indicate which components need restarted for each setting.

The following shows how to restart all services or individual services.

# restart all services on a server
cd /opt/kasm/bin
./stop
./start

# restart individual components
sudo docker restart kasm_agent
sudo docker restart kasm_api
sudo docker restart kasm_manager
sudo docker restart db
sudo docker restart proxy
sudo docker restart kasm_guac
sudo docker restart rdp_gateway
sudo docker restart kasm_rdp_https_gateway

Note: Kasm Workspaces also provides a restart script. Use the --help flag with the restart and stop scripts in /opt/kasm/bin to view all available options.

Authentication

NameDescriptionServices Need Restarted
Anonymous User ExpirationAnonymous user accounts are deleted from the system after the defined number of hours. Set this value to 0 to disable automatic deletion.None
Enable Kasm AuthorizationRequires client requests to the Kasm for content such as downloads and uploads to be authenticated with the user's current session token.None
Enable SAMLEnables Single Sign on with SAML 2.0 for users.None
Kasm Authorization DomainOverride the domain used in the Kasm session cookie. The default value will use the domain name the user request came in on, which will fit most use cases. Statically setting the domain name will ensure your Workspaces deployment cannot be proxied under different domain names.None
Login AssistanceAn optional link to display on the login page that will direct users to another site for login assistance.None
Max Login AttemptsThe number of invalid login attempts before an account is locked out. This setting only applies to local accounts.None
Notice MessageA login banner message to show to users at the login page.None
Notice TitleThe title of the login banner to show to users at the login page.None
Component Registration TokenUsed for multi-server deployments to register new components to the deployment.None
Same Site Cookie PolicyConfigures the SameSite attribute for the Set-Cookie HTTP response headers. Valid options are Lax, Strict and None.API
Session LifetimeThe number of seconds a session token is valid for.API
Token DriftHow many minutes plus and minus to allow TOTP tokens to drift from the server's UTC time.API
WebAuthn Request LifetimeThe number of seconds a WebAuthn Authenticator or Registration session is valid for.API
API Token Lifespan (seconds)Lifespan of the component auth tokens used for back-end requests, in seconds.None
API Token Refresh Leeway (seconds)Additional refresh window for API tokens, in seconds.None

CAPTCHA Settings

The CAPTCHA settings allow administrators to select which type of CAPTCHA they want to use if they choose to use CAPTCHA. This is used on session casting.

NameDescriptionServices Need Restarted
CAPTCHA SelectionChoose which type of CAPTCHA to use, selecting one will automatically attempt to set the API URL.None
CAPTCHA API URLThe API URL to use for verifying results, the correct URL should automatically be set when a CAPTCH type is selected.None
CAPTCHA Private KeyThe CAPTCHA Private Key,None
CAPTCHA Site KeyThe CAPTCHA Site Key.None

Connections

NameDescriptionServices Need Restarted
Default VM RDP Connection SettingsSee detailed description below.API
Default VM SSH Connection SettingsSee detailed description below.API
Default VM VNC Connection SettingsSee detailed description below.API
RDP config file expirationHow long the authentication token in the generated RDP file is valid.API
RDP Private KeyThis key is used to generate the JWT tokens used for authenticating the RDP file by the RDP Gateway.API
RDP Public CertThis certificate is used to validate the JWT tokens used for authenticating the RDP file by the RDP Gateway.API
RDP File Signing Private KeyThe private key that is used to sign the RDP file.API
RDP File Signing CertThe certificate used to verify the signed RDP file has not been modified, this is also used to set the trusted publishers setting in microsoft group policy.API

Default VM RDP Connection Settings

This Kasm setting is used to define a series of connection parameters for connecting to external RDP/KasmVNC endpoints. It is defined as a single JSON string, a default example is:

{
"guac": {
"type": "rdp",
"settings": {
"security": "any",
"ignore-cert": true,
"enable-font-smoothing": true,
"enable-wallpaper": true,
"enable-theming": true,
"enable-full-window-drag": false,
"enable-menu-animations": false,
"resize-method": "display-update",
"server-layout": "en-us-qwerty",
"printer-name": "Kasm"
}
},
"kasm_svc": {
"port": 4902
}
}

A break-down of the Guacamole (guac/rdp) settings can be found below:

NameDescription
securityThe security mode to use for the RDP connection. This mode dictates how data will be encrypted and what type of authentication will be performed, if any. Options any,nla,nla-ext,tls,vmconnect,rdp.
ignore-certIf set to “true”, the certificate returned by the server will be ignored, even if that certificate cannot be validated.
enable-font-smoothingIf set to “true”, text will be rendered with smooth edges. Text over RDP is rendered with rough edges by default.
enable-wallpaperIf set to “true”, enables rendering of the desktop wallpaper. By default, wallpaper will be disabled, such that unnecessary bandwidth need not be spent redrawing the desktop.
enable-themingIf set to “true”, enables use of theming of windows and controls. By default, theming within RDP sessions is disabled.
enable-full-window-dragIf set to “true”, the contents of windows will be displayed as windows are moved. By default, the RDP server will only draw the window border while windows are being dragged.
enable-menu-animationsIf set to “true”, menu open and close animations will be allowed. Menu animations are disabled by default.
resize-methodThe method to use to update the RDP server when the width or height of the client display changes. Options display-update,reconnect.
fixed-display-sizeIf this is set to "true", the resolution of the RDP session will be fixed to the resolution specified by the provided width and height settings.
server-layoutThe server-side keyboard layout. Options da-dk-qwerty,de-ch-qwertz,de-de-qwertz,en-gb-qwerty,en-us-qwerty,es-es-qwerty,fr-ch-qwertz,fr-fr-azerty,it-it-qwerty,ja-jp-qwerty,pt-br-qwerty,sv-se-qwerty,tr-tr-qwerty.
timezoneThis parameter allows control of the timezone that is sent to the server over the RDP connection, which will change the way local time is displayed on the server when that server is part of a RDS cluster. Kasm will auto fill in this parameter based on the Kasm Session Timezone user profile setting when not overridden in the server configuration or this global setting.
printer-nameThe name of the redirected printer device that is passed through to the RDP session. The final name displayed in all printing related settings will be in the format printer_name (redirected session_id). This is a naming convention imposed by Windows to indicate that it is a redirected printer, with session_id denoting the specific session the printer is associated with.

Additional Guacamole connection settings can be found here.

Examples for Keyboard Layout setup
Example 1

When using an RDP connection to a Windows VM configured with a German keyboard layout, the correct way to inform Guacamole is by setting server-layout to de-de-qwertz. This ensures that Guacamole interprets the client’s keycodes according to the German layout expected by the server, regardless of the client’s actual keyboard.

{
"guac": {
"type": "rdp",
"settings": {
"server-layout": "de-de-qwertz"
}
}
}

This allows users with different local layouts (such as US or UK keyboards) to connect and still have keys correctly mapped according to the German layout used on the remote system.

Example 2

In contrast, if using a general VNC connection, Guacamole relies on the keyboard-layout setting to interpret the key presses as if the client is using a specific layout. For example, to interpret the keyboard input as coming from a Swedish keyboard, you would configure:

{
"guac": {
"type": "rdp",
"settings": {
"keyboard-layout": "sv-se-qwerty"
}
}
}

This is useful when the remote environment does not dictate the keyboard mapping, and the desired behavior is to match the client’s keyboard layout.

Note: Administrators can explicitly define display-related settings such as dpi, width, and height in the rdp_thick_client_properties. If these values are not provided, the system will automatically populate them based on the user's display scaling preferences in the browser at session launch time. However, its observed that many RDP client applications ignore the specific scaling in favor of dynamic DPI/resolution sync.

RDP Session Watermarking

Kasm supports watermarking RDP sessions with customizable text overlays as well as images. The watermark settings are configured within the kasm_svc section of the VM RDP connection settings JSON. The connection settings can be overridden at the Server level or Auto Scale Configs for auto scaled servers.

Note

The watermark feature is limited to configurations where the username is known at session creation time. This includes Static Credentials, Single Sign-On with Static Local Accounts, Single Sign-On with Dynamic Local Accounts, and Single Sign-On with Active Directory.

warning

There are limited UI elements that may appear over the watermark. At this time, the only known UI elements known to appear over the watermark is the start menu and the Task Manager.

The following is an example of a valid watermark configuration:

{
"guac": {
"type": "rdp",
"settings": {
"security": "any",
"ignore-cert": true,
"enable-font-smoothing": true,
"enable-wallpaper": true,
"enable-theming": true,
"enable-full-window-drag": false,
"enable-menu-animations": false,
"resize-method": "display-update",
"server-layout": "en-us-qwerty",
"printer-name": "Kasm"
}
},
"kasm_svc": {
"port": 4902,
"watermark": {
"text": "${KASM_USER} at %H:%M on %d/%m/%Y",
"tint": "255,0,255,255",
"repeat-spacing": 100
}
}
}

A break-down of the allowed watermark settings can be found below:

SettingDefaultDescription
textThe text content of the watermark can include the following session variables: ${KASM_USER}, ${KASM_USER_ID}, ${KASM_ID}, ${WINDOWS_USER} as well as time formatting using the format %H:%M:%S.
timezoneThe timezone to be used for time formatting, ie. "America/New_York".
fontArialThe font family to use for the watermark text.
font-size20The font size in points for the watermark text.
tint"255,255,255,255"The color value for the watermark in "r,g,b,a" format where each value is between 0 and 255.
opacity1.0The opacity of the watermark image in range 0.0 to 1.0.
locationcenterThe x,y coordinate location for the watermark in "x,y" format. The default value is "center". However, defining repeat-spacing will overwrite this default, changing the placement of the watermark accordingly.
rotationThe rotation in degrees for the watermark text in range -180 to 180.
repeat-spacingThe spacing in pixels to repeat the watermark text across the session both horizontally and vertically.
imageThe absolute path to the image file to be displayed as the watermark

Setting RDP Thick Client Properties

All supported RDP file parameters are documented in Microsoft's RDP file reference, The following is an example of a valid connection_info JSON object that can be used to set RDP client fields:

{
"guac": {
"type": "rdp",
"settings": {
"security": "any",
"ignore-cert": true,
"enable-font-smoothing": true,
"enable-wallpaper": true,
"enable-theming": true,
"enable-full-window-drag": false,
"enable-menu-animations": false,
"resize-method": "display-update",
"server-layout": "en-us-qwerty",
"printer-name": "Kasm",
"remote-app": "||KasmLauncher",
"remote-app-args": "\"C:\\Program Files\\Microsoft Office\\root\\Office16\\EXCEL.EXE\" C:\\Users\\Public\\Documents\\example.xlsx"
}
},
"rdp_thick_client_properties": {
"connection type": 6,
"networkautodetect": 1,
"bandwidthautodetect": 1,
"screen mode id": 2,
"singlemoninwindowedmode": 1,
"keyboardhook": 2,
"disable full window drag": 1,
"disable menu anims": 1,
"bitmapcachepersistenable": 1,
"session bpp": 32,
"dynamic resolution": 1,
"autoreconnection enabled": 1,
"videoplaybackmode": 1,
"allow desktop composition": 1,
"disable themes": 0,
"allow font smoothing": 1,
"smart sizing": 1,
"desktopscalefactor": 100
},
"kasm_svc": {
"port": 4902
}
}

The rdp_thick_client_properties section within connection_info allows customization of low-level RDP client parameters to fine-tune performance, display, and user experience.

Field NameDefaultDescription
connection type6The type of connection (e.g., 6 for RDP).
networkautodetect1Enables automatic network detection.
bandwidthautodetect1Enables automatic bandwidth detection.
screen mode id2screen mode id setting (1 = windowed, 2 = full screen).
singlemoninwindowedmode1Enables single monitor when in windowed mode.
keyboardhook2Controls keyboard shortcut handling behavior.
disable full window drag1Disables full window drag visuals to improve performance.
disable menu anims1Disables menu animations to reduce resource usage.
bitmapcachepersistenable1Enables persistent bitmap caching between sessions.
session bpp32Bits-per-pixel for session color depth (e.g., 16, 24, 32).
dynamic resolution1Enables dynamic adjustment of session resolution.
autoreconnection enabled1Automatically reconnects the session if the connection drops.
videoplaybackmode1Enables optimized video playback mode.
allow desktop composition1Enables desktop composition (Aero effects) if supported.
disable themes0If set to 1, disables themes; 0 leaves them enabled.
allow font smoothing1Enables font smoothing for better text rendering.
smart sizing1Enables the local device scaling the content of the remote session to fit the window size.
desktopscalefactor100Specifies the scale factor of the remote session to make the content appear larger.

Note: The desktopscalefactor property is being deprecated and will soon be unavailable as informed by Microsoft Support.

Fields Overridden by Kasm Group Settings

Some RDP parameters are automatically overridden by Kasm Group Settings and cannot be set manually in the connection info object. These ensure consistent security and policy enforcement across sessions. These include:

SettingDescriptionKasm Group Setting Key
full addressTarget server addressconnection_proxy_address
usernameRDP usernameDerived from authenticationtoken
domainRDP domainDerived from authenticationtoken
use multimonMulti-monitor supportcontrol_panel.show_display_manager
drivestoredirectLocal drive redirectionallow_kasm_rdp_map_local_drives
redirectsmartcardsSmart card redirectionallow_kasm_smart_card_passthrough
audiocapturemodeMicrophone supportallow_kasm_microphone
camerastoredirectWebcam supportallow_kasm_webcam
redirectclipboardClipboard redirectionallow_kasm_clipboard_up/down
redirectprintersPrinter redirectionallow_kasm_printing
redirectwebauthnWebAuthn redirectionallow_kasm_rdp_webauthn_passthrough

Default VM VNC Connection Settings

This Kasm setting is used to define a series of connection parameters for connecting to external VNC endpoints. It is defined as a single JSON string, a default example is:

{
"guac": {
"type": "vnc",
"settings": {
"autoretry": 5,
"color_depth": 32
}
}
}

A break-down of the Guacamole (guac/vnc) settings can be found below:

NameDescription
hostnameThe hostname or IP address of the VNC server.
portThe port the VNC server is listening on.
autoretryThe number of times to retry connecting before returning an error.
swap-red-blueBoolean that will swap red and blue colors to correct display colors being swapped.
cursorSet to "remote" to have the mouse pointer rendered on the remote server.
encodingsA space-delimited list of VNC encodings to use.
read-onlyIf set to “true”, the vnc connection made will be read-only, input will not be accepted.

Additional Guacamole connection settings can be found here.

Default VM SSH Connection Settings

This Kasm setting is used to define a series of connection parameters for connecting to external SSH endpoints. It is defined as a single JSON string, a default example is:

{
"guac": {
"type": "ssh",
"settings": {
"font-size": "11",
"color-scheme": "gray-black",
"font-name": "monospace",
"scrollback": "1000"
}
}
}

A break-down of the Guacamole (guac/ssh) settings can be found below:

NameDescription
hostnameThe hostname or IP address of the SSH server.
portThe port the SSH server is listening on.
host-keyThe known hosts entry for the SSH server. This parameter is optional, and, if not provided, no verification of host identity will be done.
server-alive-intervalBy default the SSH client does not send keepalive requests to the server. This parameter allows you to configure the the interval in seconds at which the client connection sends keepalive packets to the server.
color-schemeThe color scheme to use for the terminal emulator used by SSH connections. For details on each option see the Guacamole documentation at the link below.
font-nameThe name of the font to use.
font-sizeThe font size to use in points.
scrollbackThe maximum number of rows to allow within the terminal scrollback buffer.
commandThe command to execute over the SSH session, if any. This parameter is optional. If not specified, the SSH session will use the user's default shell.
localeThis parameter allows control of the specific locale to request for the SSH session. This parameter is optional and may be any value accepted by the LANG environment variable of the SSH server. Kasm will auto fill in this parameter based on the Kasm Session Language user profile setting when not overridden in the server configuration or this global setting.
timezoneThis parameter allows control of the timezone that is sent to the server over the SSH connection, which will change the way local time is displayed on the server. Kasm will auto fill in this parameter based on the Kasm Session Timezone user profile setting when not overridden in the server configuration or this global setting.

Additional Guacamole connection settings can be found here.

Egress Plugin

The Egress Plugin settings are only applicable when a license has been applied to Kasm Workspaces that includes seats for an Egress Plugin.

NameDescriptionServices Need Restarted
Egress Plugin Update CheckAllow for Egress Plugins to check in to Update Egress Gateways and Egress Accounts.None
Egress Plugin Update URLThe URL Used to Update Egress Gateways and Egress Accounts associated with an Egress Plugin.None

Experimental Features

By enabling this setting, you will be enabling Experimental Kasm features within your platform. These features have been developed by Kasm but may not be fully productized at the time of addition to the platform. If an experimental feature has a configuration, turning off the experimental features flag will disable those configs. After re-enabling experimental features you would need to re-enable the config as well.

NameDescriptionServices Need Restarted
Enable Experimental FeaturesWhether to enable experimental features or notNone

Workspaces

NameDescriptionServices Need Restarted
Add Workspaces To Default GroupAutomatically add workspaces to default group when new images are added.API
Default CPU Allocation MethodSets the default cpu allocation strategy for container images. Valid options are Quotas or Shares. See cpu-resource-allocation for more details.None

Knowledgebase

NameDescriptionServices Need Restarted
Knowledgebase URLThis is the base URL for the documentation.None

Licensing

NameDescriptionServices Need Restarted
License Server URLThe URL to the Kasm Licensing Server.None

Logging

Kasm provides centralized logging out of the box, whether you install Kasm all on a single server in a distributed system with redundant API servers and multiple Kasm agents, all logs are collected and aggregated. Kasm provides basic log aggregation, analyses, and storage. The system also support logging directly to Splunk or File Based Logs can be ingested by a SIEM solution of choice.

NameDescriptionServices Need Restarted
Debug Log RetentionNumber of hours to keep debug logs. Default is 4 hours. See the section on log retention for more details.None
Splunk HEC TokenFor Splunk logging, this token provides authenticationManager, API
HTTP MethodThe HTTP method to use, POST or PUT are supported.Manager, API
Disable Log Certificate ValidationIf set to true, the remote logging server's certificate is ignored. This is required if using self signed certs. If you use properly signed certs you do not need to enable this.Manager, API
Log HostThe hostname or IP address of the remote logging system.Manager, API
Log PortThe port number for the remote logging system. Splunk's default is 8088 other systems may use 443.Manager, API
Log ProtocolRemote logging protocol. Valid values are https and splunk.Manager, API
Log RetentionNumber of days to keep local logs (excluding debug logs). See the section on log retention for more details.None
URL EndpointThe URI path for the logging system. See the sections below for specific logging solutions like Splunk.Manager, API

Native Kasm Logging

By default, logs are stored in the Kasm database. Kasm managers and Kasm API servers write their logs directly to the database. Kasm Agent nodes send logs via HTTPs to their respective Kasm Manager. The Kasm Dashboard relies on the native logging to provide visual statistics. Native logging cannot be disabled, if you enable remote logging the native logging will continue. See the log settings table for details on adjustments to default log settings.

Splunk Logging

Kasm supports Splunk HEC logging over HTTPS. See Splunk documentation for details on configuring a HEC input. Note that the URI path for a Cloud Splunk instance and a self hosted Splunk instance are different. The example configuration below is for Splunk Cloud SaaS. A cloud instance will have two domain names, the one you access the UI from and one for inputs. Per the linked documentation, the Splunk Cloud SaaS domain name for data input is the same as the UI but with input- at the front.

  • Log Protocol - splunk
  • Log Host - input-your_cloud_splunk_hostname
  • Log Port - 8088
  • URL Endpoint - /services/collector/event
  • HTTP Method - POST
  • Disable Log Certificate Validation - false
  • Splunk HEC Token - Splunk 12345678-1234-1234-1234-1234567890AB

Note: Include the "Splunk" prefix manually in the Splunk HEC Token field, if required by your HEC endpoint.

Logging Retention

Logging retention applies only to local logging, it does not affect remote logging. Before adjusting the Log Retention or Debug Log Retention you should evaluate your database system. Ensure the database system has adequate storage and processing power to handle the increased logging. If log retention beyond 30 days is required, it is highly recommended to use a proper external logging solution. The Debug Log Retention setting should not be adjusted unless needed to troubleshoot issues over a longer period of time. A Kasm system can produce over 10,000 debug logs per hour, therefore, the retention of those logs should be considered very carefully.

Manager

NameDescriptionServices Need Restarted
Agent VersionThis setting is used to restrict which versions of the Kasm Agent are allowed to communicate with the Manager.Manager
Primary Manager TimeoutThe number of seconds until the primary manager is considered unavailable. If other managers are alive one will take over the primary role.None
Same Zone ReplyIf set to true, a manager will only reply to agent heartbeats with a list of managers in the same zone as itself. Otherwise a list of all managers is given. This allows Agents to failover to managers in other zones.Manager
TokenAn authentication token used in the communication between Kasm Agents and the Manager API server.Manager
Update CheckThis setting will enable/disable the manager checking for Kasm system updates.None

Web Filter

NameDescriptionServices Need Restarted
Web Filter Update URLURL used to interface with Kasm's URL category serviceAPI
Web Filter Default Category Expiration (Hours)URL categorization results will be cached for the specified time, defined in hours. This setting applies to domains that have a category other than Uncategorized.API
Web Filter Uncategorized Expiration (Hours)URL categorization results will be cached for the specified time, defined in hours. This setting only applies to domains that are currently categorized as Uncategorized.API

Scale

NameDescriptionServices Need Restarted
Automatically Enable AgentsAutomatically enable agents if disabled every time they check in.None
Guardian IntervalHow often to run the guardian. Guardian handles cleanup of agents and Kasms. As well as provision of autoscale agents.Manager
Guardian Provision ThreadsNumber of threads to use for tear down and provision tasks.Manager
Host Dead ExpirationHow long to wait after an agent stops checking in before marking it dead. If it was auto provisioned, it will be cleaned up once marked dead.Manager
Host Missing ExpirationHow long to wait after an agent stops checking in before marking it missing. This value should always be less than the Host Dead ExpirationManager
Keep Alive ExpirationHow long the session will stay alive when no client is connected. This is the global setting, can be overridden at the group level.API
Provision TimeoutHow long to wait for an autoscale VM to finish provisioning.API, Manager
Component Missing ExpirationChange components to a Missing status after they fail to check in within this timeframe. This applies to components such as connection proxies.None
Component Dead ExpirationAutomatically delete components that fail to check in within this timeframe, a value of 0 disables this feature. This applies to components such as connection proxies.None

Theme

NameDescriptionServices Need Restarted
Launcher Background URLThis URL provides the location of a background image to use on the Workspaces launcher. Kasm Workspaces provides several built-in background options that are listed in the "Default Backgrounds" section of Custom Branding. After changing the setting, please logout and log back in for the setting to take effect.None

Storage

NameDescriptionServices Need Restarted
Object Storage KeyAWS Access Key ID used to access S3, used for S3 based persistent profiles.API
Object Storage SecretAWS Access Key Secret used to access S3, used for S3 based persistent profiles.API

Recording

NameDescription
Session Recording FramerateThe framerate for session recordings. A minimum of 2 frames per second is supported for RDP, VNC and SSH sessions. More frames per second will result in smother video but higher storage and bandwidth usage.
Session Recording BitrateThe bitrate for session recordings. A higher bitrate will result in higher quality recordings, but also higher storage and bandwidth usage. It is measured in Mbps.
Session Recording WidthThe width for session recordings. This is the number of pixels in width the video is, a higher number gives higher quality recordings, while increasing storage and bandwidth usage.
Session Recording HeightThe height for session recordings. This is the number of pixels in height the video is, a higher number gives higher quality recordings, while increasing storage and bandwidth usage.
Session Recording Upload LocationThe upload location will be a dynamic URL pointing to an AWS S3 Bucket where the session recording will be stored. This must be the full video path including the filename ending in .mp4.
Each file will have the epoch added to allow uploading multiple clips per session.
The URL can include several templated variables to tailor the storage path. See Session Recording for more details.
An example of a valid URL is: s3://session-recordings/{username}/{kasm_id}.mp4
Session Recording Queue LengthFor RDP, VNC and SSH sessions this is how many recording clips are being processed and uploaded at once on each connection proxy server. For higher concurrent session counts this number should be increased.
This will have an effect on the number of CPU cores and memory that are available to handle proxying connections to RDP, VNC and SSH sessions and so resources for the connection proxy server should be
adjusted accordingly. Session recording encoding is quite CPU intensive. Refer to the Kasm sizing guide for more information
Session Recording Retention PeriodThis value is how long the connection proxy will continue to try and upload recorded clips that have failed to upload. This value is measured in hours and applies to RDP, VNC, and SSH sessions only.
Clips that have failed to upload and haven't exceeded the retention period can also be copied out from the folder /opt/kasm/current/tmp/guac/recordings on the connection proxy.
Object Storage Access Key IDObject storage (S3) access key ID. This ID is specific for session recording purposes.
Object Storage Access Key SecretObject Storage Access Key Secret. This secret is specific for session recording purposes.
Disk Usage Limit for Session RecordingsThis is a percentage of the disk space that is allowed to be consumed on the Connection Proxy, before session recording will stop and session creation when session recording is enabled will fail.
The default value is 0.90 or otherwise saying when the disk is 90% full session recording stops

Setting Properties

The following table lists the properties of each setting.

NameSetting name
CategorySetting Category
Services RestartWhat services need to be restarted on setting change
ValueSettings Actual Value
Value TypeData Type
DescriptionSetting Description