---
myst:
  html_meta:
    "description lang=en": "Share Kasm Workspaces session with other users via a URL usage and configuration guide. "
    "keywords": "Kasm, Session, Sharing, Spectator"
    "property=og:locale": "en_US"
---
```{title} Session Sharing
```

# Session Sharing

Administrators can allow users to place an existing session in sharing mode which will generate
a unique URL for the session. This URL can be used by other authenticated users to join a room that has
chat and a view-only stream of the session. Any authenticated user may join a shared session if the URL is known.

```{figure} /images/session_sharing/session.png
:align: center
:width: 60%

Shared Session
```

## Shared Session Group Settings

In order to place a session in sharing mode, the user must have the **allow_kasm_sharing**
{doc}`Group Setting <groups>` configured to **True** (Default: False).

Additional Group Settings may also be configured:

- **shared_session_full_control** (Default: False) -  When enabled, all users who join the shared session will have the ability to control
  the mouse and keyboard input. (not recommended)
- **lock_sharing_video_mode** (Default: True)  -  When enabled, the resolution and aspect ratio for the session is fixed
  to 720p. These defaults are best for bandwidth consumption and to ensure all users have a consistent experience.
  When disabled, the owner of the session is allowed to change the video setting back to the defaults where the resolution
  changes to fit the owners window.

```{figure} /images/session_sharing/group_settings.png
:align: center
:width: 60%

Shared Session Group Settings
```

## Initiating a shared session

- Launch a Kasm session
- Expand the control panel and click the **Share Instance** button.
- Click **Share Session**

```{figure} /images/session_sharing/share_session_1.png
:align: center
:width: 60%

Configuring a shared session
```

- A URL will be generated. Give this URL to the desired users.

```{figure} /images/session_sharing/share_session_2.png
:align: center
:width: 60%

Configuring a shared session
```