--- myst: html_meta: "description lang=en": "Discover how to effortlessly share your Kasm Workspaces sessions with other users using a unique URL. Learn how to collaborate in real-time, provide remote assistance, and conduct engaging presentations. This comprehensive usage and configuration guide for the Session Sharing feature ensures a seamless and secure sharing experience. Empower teamwork, boost productivity, and enable interactive sessions with Kasm's powerful Session Sharing capabilities." "keywords": "Kasm Workspaces, session sharing, collaborative work, remote assistance, presentations, real-time collaboration, interactive sessions, shared sessions, URL sharing, teamwork, productivity, secure sharing, configuration guide" "property=og:locale": "en_US" --- ```{title} Session Sharing ``` # Session Sharing The Session Sharing feature in Kasm allows users to place an existing session in “sharing mode”. This generates a unique URL that can be shared with other authenticated users, granting them the ability to view or interact with the session. When session sharing is enabled, the shared session is framed within a user interface that allows participants to see who is also viewing the shared session and to interact with each other using chat communications. ```{warning} Any authenticated user may join a shared session if the URL is known. ``` ```{figure} /images/session_sharing/Shared_Session.webp :align: center **Shared Session** ``` ## Benefits and Use Cases Session sharing offers several benefits and can be used in various scenarios, including: - **Collaborative Work:** Users can work together in real-time, reviewing and editing documents, code, or designs. - **Remote Assistance:** Experts can provide guidance and support by remotely accessing and assisting users in their sessions. - **Presentations and Demos:** Users can share their sessions to demonstrate software, conduct training sessions, or deliver presentations to a wider audience. ## Security Considerations It's important to consider the following security aspects when using session sharing: - **Trustworthy Participants:** Only share the session URL with trusted individuals, as anyone with the URL can join the shared session. - **Confidential Information:** Avoid sharing sensitive or confidential information during shared sessions to maintain data security and privacy. ## Shared Session Group Settings The shared session control panel item is only available to users if the Workspaces administrator has configured the **allow_kasm_sharing** {doc}`Group Setting ` configured to **True** (Default: True). By default, only the initiator of the shared session will be able to control the session, while all other participants are in view-only mode. If the **shared_session_full_control** (Default: False) {doc}`Group Setting ` is enabled, all users who join the shared session will have the ability to control the mouse and keyboard input. ```{warning} Have multiple users interacting with a single shared session simultaneously can result in an inconsistent user experience. ``` ## Chat Communication Participants in a shared session can communicate with each other using the chat feature. They can exchange messages, links, and other information relevant to the session. However, please note that there may be limitations on the chat functionality, such as character limits or restrictions on file sharing capabilities. ## Session Control By default, only the initiator of the shared session has control over the session, while other participants are in view-only mode. It is important to clarify that participants cannot control the session unless the initiator grants them control. Consider specifying whether participants can request control or perform limited actions in view-only mode. ## User Interface The user interface for participants in a shared session includes the following elements: - Participant List: A list displaying the users who are currently viewing the shared session. - Active User Indicators: Visual indicators to identify which users are actively engaged in the session. - Additional Controls: Any specific controls or features designed for shared sessions. ## Video and Audio Settings During a shared session, video and audio settings available to participants if allowed via Group settings by the administrator. It is essential to clarify any restrictions or limitations on video and audio functionality during shared sessions. By default, when the shared session is initiated, the streaming resolution and aspect ratio for the session is fixed to 720p to reduce bandwidth consumption and to ensure all users have a consistent user experience. If the admin disables the **lock_sharing_video_mode** (Default: True) the session initiator is able to change the video settings to allow for higher resolutions or for the stream to match their browser window. ```{warning} Mixing video mode resolutions across multiple participants with different screens sizes/resolutions can result in an inconsistent user experience. ``` ```{figure} /images/session_sharing/Shared_Session_Group_Settings.webp :align: center **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**, the URL you need to pass on to users will automatically be added to your clipboard and you will receive a notification. ```{figure} /images/session_sharing/Configuring_A_Shared_Session.webp :align: center **Configuring a shared session** ``` - You can also get the URL from the control panel menu as well as stop sharing. ```{figure} /images/session_sharing/Configuring_A_Shared_Session_2.webp :align: center **Configuring a shared session** ```