---
myst:
  html_meta:
    "description lang=en": "Learn how to configure MacOS servers in Kasm Workspaces for remote access. Follow our step-by-step guide to enable remote management, set up VNC connection, and create workspaces."
    "keywords": "Kasm, MacOS, Kasm Workspaces, MacOS servers, remote access, remote management, VNC, virtualization, remote desktop, workspaces, configuration, setup, tutorial, step-by-step guide"
    "property=og:locale": "en_US"
---
```{title} MacOS Workspaces
```

# MacOS Workspaces

This step-by-step tutorial will walk you through the process of enabling remote management on MacOS and configuring the server in Kasm Workspaces. By following these instructions, you'll be able to seamlessly access and utilize MacOS systems remotely. 

## Enabling Remote Management in MacOS

To begin, you need to enable remote management on your MacOS system. Remote management allows you to access and control your MacOS system from a remote location.

1. Open the `Settings` app on your MacOS system and navigate to the `General` section.
2. Scroll down to locate and click on `Sharing`.

```{figure} /images/macos_servers/image1.webp
:align: center
**Location of Sharing Section**
```

3. Within the `Sharing` settings, find the option labeled `Remote Management` and enable it.
4. Click on the `information icon` next to the Remote Management toggle.

```{figure} /images/macos_servers/image2.webp
:align: center
**Location of Remote Management**
```

5. (Optional) If you want to customize the remote management options further, click on the computer settings button. Uncheck all the boxes and click OK.

```{figure} /images/macos_servers/image3.webp
:align: center
**Remote Management Options**
```

6. To refine access permissions, change the option from `All Users` to `Only these users`.
7. Add your user account to the list of allowed users.
8. Click on your user account and select `Options`.
   - Check the `Observe` checkbox to enable viewing the MacOS system remotely.
   - Check the `Control` checkbox to allow remote control of the MacOS system.
   - Click `OK` to save the settings.

```{figure} /images/macos_servers/image4.webp
:align: center
**Adding User to Only These Users**
```
By completing these steps, you have successfully enabled remote management on your MacOS system, allowing it to be accessed remotely.

## MacOS Server Configuration

Now that remote management is enabled on your MacOS system, it's time to configure it in Kasm Workspaces. Follow the steps below to set up the server:

1. Log in to Kasm as an administrator using your credentials.
2. In the Kasm dashboard, navigate to the `Infrastructure` section and select `Servers`.
3. Locate the `Servers List` and click on the `Add` button.
4. In the `Create Server` panel, provide the following information:
   - Choose a `Friendly name` for your server to easily identify it.
   - Enter the `IP address` of the MacOS system you want to connect to.
   - Select `VNC` as the `Connection Type`, which is the remote access protocol used by MacOS.
   - Set the `Port` to `5900`, the default port for VNC.
   - Enter your MacOS `Username` and `Password` to authenticate the connection.
   - Set the `Max Simultaneous Sessions` to 1, ensuring exclusive access to the server.
   - Select the desired `deployment zone`.
   - Click `Save` to save the server configuration.

```{figure} /images/macos_servers/image5.webp
:align: center
**Adding A Server to Kasm Workspaces**
```

Congratulations! You have successfully configured your MacOS system as a server in Kasm Workspaces.

## Create a Workspace

To make the MacOS system accessible to users in Kasm Workspaces, you need to create a workspace. The workspace provides a virtual environment for users to interact with the MacOS system. Follow the steps below to create a workspace:

1. Log in to Kasm as an administrator using your credentials.
2. In the Kasm dashboard, go to the `Workspaces -> Workspaces` section in the Admin UI.
3. Locate the list of workspaces and click on `Add Workspace`.
4. In the `Create Workspace` panel, provide the required information:
   - Select `Server` as the `Workspace Type` to connect to the previously configured MacOS server.
   - Enter a `friendly name` for the workspace, which will be displayed to users.
   - Provide a `description` of the workspace to give users an idea of its purpose.

```{important}
This step is optional: If you want to personalize the workspace, you can provide a **URL** to a thumbnail image that will be displayed as an icon for this workspace.
```

   - Check the `Enable` box to activate the workspace.
   - From the `server` dropdown, select the server you created in the previous section.
   - Click the `Save` button to save the workspace configuration.


By following these steps, you have successfully created a workspace, allowing users to access and utilize the MacOS system remotely through Kasm Workspaces.

Now, users can enjoy the convenience of remotely accessing and interacting with MacOS systems using Kasm Workspaces.