Skip to content

feat(aps): update remote access documentation #4213

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jan 14, 2025
Merged

feat(aps): update remote access documentation #4213

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f144c67
feat(aps): update remote access documentation
bene2k1 Jan 14, 2025
1800da3
Update bare-metal/apple-silicon/how-to/access-remote-desktop-mac-mini…
bene2k1 Jan 14, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
209 changes: 111 additions & 98 deletions bare-metal/apple-silicon/how-to/access-remote-desktop-mac-mini.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,109 +32,122 @@ The VNC protocol is platform-independent, supporting Linux, Windows, and macOS,
For manual connections, ensure that the port from the **Overview** section is correctly entered in your VNC client settings, as this is necessary for a successful connection.
</Message>

<Tabs id="os">
<TabsTab label="macOS">
If your local machine runs macOS, you can use the Scaleway console to connect to your Mac mini using the built-in Apple ARD client.

1. Click **Apple silicon** in the **Bare Metal** section of the side menu. A list of your Mac minis displays.
<Lightbox src="scaleway-apple-silicon-dashboard.webp" alt="Scaleway Apple Silicon Dashboard" />
2. Click the Mac mini you want to connect to. The **Overview** page of your Mac mini displays.
3. Click **Open remote desktop** in the **Access remote desktop from macOS ①** section to launch Apple's built-in screen sharing client for a seamless remote desktop experience.
<Lightbox src="scaleway-apple-silicon-remote-desktop.webp" alt="Scaleway Apple Silicon remote desktop selector" />

Once your screen displays in your remote desktop client, log in to the graphical environment of macOS using the remote user and your password (available on the **Overview** page of your Mac mini).

<Message type="note">
macOS may ask for your password once logged into the remote desktop session. Change the keyboard layout of macOS to your computer's local keyboard layout before entering the password. Click "U.S. keyboard" in the top right corner to display a list of all available keyboard layouts.
</Message>

You are now logged in and can use your Mac mini as if you were physically present.

<Lightbox src="scaleway-m1-remote-desktop.webp" alt="Scaleway remote desktop" />

</TabsTab>
<TabsTab label="Windows">
If your local machine runs Windows, you will need to install a remote desktop client to access the remote desktop of the Mac mini.

1. Click **Apple silicon** in the **Bare Metal** section of the side menu. A list of your Mac minis displays.
<Lightbox src="scaleway-apple-silicon-dashboard.webp" alt="Scaleway Apple Silicon Dashboard" />
2. Click the Mac mini you want to connect to. The **Overview** page of your Mac mini displays.
3. Configure your remote desktop client for Windows for the connection. We suggest using one of these two remote desktop clients:
<Message type="note">
These clients are free versions of commercially supported solutions and may have usage restrictions.
</Message>

- **RealVNC:**
- Download [RealVNC Viewer](https://www.realvnc.com/en/connect/download/viewer/)
- Open RealVNC Viewer (no sign-in required)
- Click **File** and **New Connection**
- In the **VNC Server** field, enter the Mac mini's IP address followed by the port (e.g., `192.168.1.100:5901`), then create the connection.
- Go back to the dashboard and find the Mac mini remote desktop in the Address book
- Open the remote desktop with the username and password (found in the console)

- **Devolutions Remote Desktop Manager:**
- Download [Devolutions Remote Desktop Manager](https://devolutions.net/remote-desktop-manager/)
- Download .NET Desktop Runtime if needed
- Open Remote Desktop Manager
- Click **+** and **New Entry**
- Choose **ARD**
- Enter the Mac mini's IP address in the **Host** field. Then, specify the port in the **Port** field, along with your username and password (located in the console).
- Open the session

</TabsTab>
<TabsTab label="Linux">
If your local machine runs Linux, you will need to install a remote desktop client to access the remote desktop of the Mac mini.

1. Click **Apple silicon** in the **Bare Metal** section of the side menu. A list of your Mac minis displays.
<Lightbox src="scaleway-apple-silicon-dashboard.webp" alt="Scaleway Apple Silicon Dashboard" />
2. Click the Mac mini you want to connect to. The **Overview** page of your Mac mini displays.
3. Configure your remote desktop client for the connection. We suggest using one of these two remote desktop clients:
- **Remmina:**
- [Download and install Remmina](https://remmina.org/), if necessary.
<Message type="tip">
Remmina is included in most Linux distributions by default.
</Message>
- Open Remmina and click the **+** icon in the top left to create a new quick connection.
- Enter the following parameters:
- **Protocol**: Remmina VNC Plugin
- **Server**: Your Mac mini's public IP address (found on its **Overview** page in the Scaleway console), followed by the port number, separated by a colon (e.g., `192.168.1.100:5901`).
- **Username**: The remote desktop password of your Mac mini, available on its **Overview** page in the Scaleway console.
- **Password**: The remote desktop password of your Mac mini, displayed on its **Overview** page in the Scaleway console.
- **Color depth**: High color (16 bpp) or better, otherwise the connection will fail.
- Click **Save and connect** to save these settings for future use and launch a connection to your Mac mini.
- You can now log in to the graphical environment of macOS using the user and the remote desktop password displayed in your Scaleway console.
<Message type="tip">
Once Remmina is installed and set up, you can connect to the remote desktop directly by clicking the **remote desktop** button in the console.
</Message>

- **Devolutions Remote Desktop Manager:**
- Download [Devolutions Remote Desktop Manager](https://devolutions.net/remote-desktop-manager/)
- Download .NET Desktop Runtime if needed
- Open Remote Desktop Manager
- Click **+** and **New Entry**
- Choose **ARD**
- Enter the Mac mini's IP address in the **Host** field. Then, specify the port in the **Port** field, along with your username and password (located in the console).
- Open the session
</TabsTab>
</Tabs>
<Concept>

## Accessing the remote desktop from a macOS client

If your local machine runs macOS, you can use the Scaleway console to connect to your Mac mini using the built-in Apple ARD client.

1. Click **Apple silicon** in the **Bare Metal** section of the side menu. A list of your Mac minis displays.
<Lightbox src="scaleway-apple-silicon-dashboard.webp" alt="Scaleway Apple Silicon Dashboard" />
2. Click the Mac mini you want to connect to. The **Overview** page of your Mac mini displays.
3. Click **Open remote desktop** in the **Access remote desktop from macOS ①** section to launch Apple's built-in screen sharing client for a seamless remote desktop experience.
<Lightbox src="scaleway-apple-silicon-remote-desktop.webp" alt="Scaleway Apple Silicon remote desktop selector" />

Once your screen displays in your remote desktop client, log in to the graphical environment of macOS using the remote user and your password (available on the **Overview** page of your Mac mini).

<Message type="note">
macOS may ask for your password once logged into the remote desktop session. Change the keyboard layout of macOS to your computer's local keyboard layout before entering the password. Click "U.S. keyboard" in the top right corner to display a list of all available keyboard layouts.
</Message>

You are now logged in and can use your Mac mini as if you were physically present.

<Lightbox src="scaleway-m1-remote-desktop.webp" alt="Scaleway remote desktop" />
</Concept>

<Concept>

## Accessing the remote desktop from a Windows client

If your local machine runs Windows, you will need to install a remote desktop client to access the remote desktop of the Mac mini.

1. Click **Apple silicon** in the **Bare Metal** section of the side menu. A list of your Mac minis displays.
<Lightbox src="scaleway-apple-silicon-dashboard.webp" alt="Scaleway Apple Silicon Dashboard" />
2. Click the Mac mini you want to connect to. The **Overview** page of your Mac mini displays.
3. Configure your remote desktop client for Windows for the connection. We suggest using one of these two remote desktop clients:
<Message type="note">
These clients are free versions of commercially supported solutions and may have usage restrictions.
</Message>

- **RealVNC:**
- Download [RealVNC Viewer](https://www.realvnc.com/en/connect/download/viewer/)
- Open RealVNC Viewer (no sign-in required)
- Click **File** and **New Connection**
- In the **VNC Server** field, enter the Mac mini's IP address followed by the port (e.g., `192.168.1.100:5901`), then create the connection.
- Go back to the dashboard and find the Mac mini remote desktop in the Address book
- Open the remote desktop with the username and password (found in the console)

- **Devolutions Remote Desktop Manager:**
- Download [Devolutions Remote Desktop Manager](https://devolutions.net/remote-desktop-manager/)
- Download .NET Desktop Runtime if needed
- Open Remote Desktop Manager
- Click **+** and **New Entry**
- Choose **ARD**
- Enter the Mac mini's IP address in the **Host** field. Then, specify the port in the **Port** field, along with your username and password (located in the console).
- Open the session

</Concept>

<Concept>

## Accessing the remote desktop from a Linux client

If your local machine runs Linux, you will need to install a remote desktop client to access the remote desktop of the Mac mini.

1. Click **Apple silicon** in the **Bare Metal** section of the side menu. A list of your Mac minis displays.
<Lightbox src="scaleway-apple-silicon-dashboard.webp" alt="Scaleway Apple Silicon Dashboard" />
2. Click the Mac mini you want to connect to. The **Overview** page of your Mac mini displays.
3. Configure your remote desktop client for the connection. We suggest using one of these two remote desktop clients:
- **Remmina:**
- [Download and install Remmina](https://remmina.org/), if necessary.
<Message type="tip">
Remmina is included in most Linux distributions by default.
</Message>
- Open Remmina and click the **+** icon in the top left to create a new quick connection.
- Enter the following parameters:
- **Protocol**: Remmina VNC Plugin
- **Server**: Your Mac mini's public IP address (found on its **Overview** page in the Scaleway console), followed by the port number, separated by a colon (e.g., `192.168.1.100:5901`).
- **Username**: The remote desktop password of your Mac mini, available on its **Overview** page in the Scaleway console.
- **Password**: The remote desktop password of your Mac mini, displayed on its **Overview** page in the Scaleway console.
- **Color depth**: High color (16 bpp) or better, otherwise the connection will fail.
- Click **Save and connect** to save these settings for future use and launch a connection to your Mac mini.
- You can now log in to the graphical environment of macOS using the user and the remote desktop password displayed in your Scaleway console.
<Message type="tip">
Once Remmina is installed and set up, you can connect to the remote desktop directly by clicking the **remote desktop** button in the console.
</Message>

- **Devolutions Remote Desktop Manager:**
- Download [Devolutions Remote Desktop Manager](https://devolutions.net/remote-desktop-manager/)
- Download .NET Desktop Runtime if needed
- Open Remote Desktop Manager
- Click **+** and **New Entry**
- Choose **ARD**
- Enter the Mac mini's IP address in the **Host** field. Then, specify the port in the **Port** field, along with your username and password (located in the console).
- Open the session

</Concept>

<Concept>

## Comparison matrix of remote desktop clients

Below is a matrix to compare the different features of the free versions of these remote desktop clients:

| Client | Compatible OS | Copy & Paste | Streaming Audio<sup>*</sup> | Security/Tunneling Mode | High Quality Compatibility | Display Responsiveness |
|---------------------------------|---------------|--------------------------------------------|--------------------------|--------------------------------------------------|----------------------------|------------------------|
| ARD (integrated) | macOS | ✅ (except for password) | ❌ | ✅ auto | ⭐⭐⭐ | ⭐⭐⭐ |
| RealVNC | Windows, Linux, macOS | 〰️ (some issues) | ❌ (not with free version) | ❌ (manual tunnel) | ❌ | ⭐ (not recommended) |
| Remmina | Linux | ✅ (manual, only from local to server) | ❌ | ❌ (manual tunnel) | ❌ | ⭐ |
| Devolutions Remote Desktop Manager | Windows, Linux, macOS | ✅ | ❌ | ✅ (requires additional setup - SSH tunnel) | ❌ | ⭐⭐ |

<sup>*</sup> These remote desktop clients don't allow audio streaming. If you need audio streaming, we recommend using [Reemo](/tutorials/access-mac-mini-with-reemo/). You need to configure the connection with Reemo using a VNC connection. We recommend first setup an other VNC connection and using this remote desktop client to then configure Reemo.

</Concept>

<Message type="tip">
If you encounter issues connecting to the remote desktop of your Mac mini, refer to our documentation on [Troubleshooting remote desktop connections to Mac mini servers](/bare-metal/apple-silicon/troubleshooting/cant-connect-using-vnc/).
</Message>

### Comparison matrix of remote desktop clients

Below is a matrix to compare the different features of the free versions of these remote desktop clients:

| Client | Compatible OS | Copy & Paste | Streaming Audio<sup>*</sup> | Security/Tunneling Mode | High Quality Compatibility | Display Responsiveness |
|---------------------------------|---------------|--------------------------------------------|--------------------------|--------------------------------------------------|----------------------------|------------------------|
| ARD (integrated) | macOS | ✅ (except for password) | ❌ | ✅ auto | ⭐⭐⭐ | ⭐⭐⭐ |
| RealVNC | Windows, Linux, macOS | 〰️ (some issues) | ❌ (not with free version) | ❌ (manual tunnel) | ❌ | ⭐ (not recommended) |
| Remmina | Linux | ✅ (manual, only from local to server) | ❌ | ❌ (manual tunnel) | ❌ | ⭐ |
| Devolutions Remote Desktop Manager | Windows, Linux, macOS | ✅ | ❌ | ✅ (requires additional setup - SSH tunnel) | ❌ | ⭐⭐ |

<sup>*</sup> These remote desktop clients don't allow audio streaming. If you need audio streaming, we recommend using [Reemo](/tutorials/access-mac-mini-with-reemo/). You need to configure the connection with Reemo using a VNC connection. We recommend first setup an other VNC connection and using this remote desktop client to then configure Reemo.

<Message type="note">
Mac mini and macOS are trademarks of Apple Inc., registered in the U.S. and other countries and regions. iOS is a trademark or registered trademark of Cisco in the U.S. and other countries and is used by Apple under license. Scaleway is not affiliated with Apple Inc.
</Message>
Loading