Skip to content

Commit 4322844

Browse files
bene2k1jcirinosclwy
authored andcommitted
feat(aps): update remote access documentation (scaleway#4213)
* feat(aps): update remote access documentation * Update bare-metal/apple-silicon/how-to/access-remote-desktop-mac-mini.mdx Co-authored-by: Jessica <[email protected]> --------- Co-authored-by: Jessica <[email protected]>
1 parent 1eb0d3c commit 4322844

File tree

1 file changed

+111
-98
lines changed

1 file changed

+111
-98
lines changed

bare-metal/apple-silicon/how-to/access-remote-desktop-mac-mini.mdx

Lines changed: 111 additions & 98 deletions
Original file line numberDiff line numberDiff line change
@@ -32,109 +32,122 @@ The VNC protocol is platform-independent, supporting Linux, Windows, and macOS,
3232
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.
3333
</Message>
3434

35-
<Tabs id="os">
36-
<TabsTab label="macOS">
37-
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.
38-
39-
1. Click **Apple silicon** in the **Bare Metal** section of the side menu. A list of your Mac minis displays.
40-
<Lightbox src="scaleway-apple-silicon-dashboard.webp" alt="Scaleway Apple Silicon Dashboard" />
41-
2. Click the Mac mini you want to connect to. The **Overview** page of your Mac mini displays.
42-
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.
43-
<Lightbox src="scaleway-apple-silicon-remote-desktop.webp" alt="Scaleway Apple Silicon remote desktop selector" />
44-
45-
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).
46-
47-
<Message type="note">
48-
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.
49-
</Message>
50-
51-
You are now logged in and can use your Mac mini as if you were physically present.
52-
53-
<Lightbox src="scaleway-m1-remote-desktop.webp" alt="Scaleway remote desktop" />
54-
55-
</TabsTab>
56-
<TabsTab label="Windows">
57-
If your local machine runs Windows, you will need to install a remote desktop client to access the remote desktop of the Mac mini.
58-
59-
1. Click **Apple silicon** in the **Bare Metal** section of the side menu. A list of your Mac minis displays.
60-
<Lightbox src="scaleway-apple-silicon-dashboard.webp" alt="Scaleway Apple Silicon Dashboard" />
61-
2. Click the Mac mini you want to connect to. The **Overview** page of your Mac mini displays.
62-
3. Configure your remote desktop client for Windows for the connection. We suggest using one of these two remote desktop clients:
63-
<Message type="note">
64-
These clients are free versions of commercially supported solutions and may have usage restrictions.
65-
</Message>
66-
67-
- **RealVNC:**
68-
- Download [RealVNC Viewer](https://www.realvnc.com/en/connect/download/viewer/)
69-
- Open RealVNC Viewer (no sign-in required)
70-
- Click **File** and **New Connection**
71-
- 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.
72-
- Go back to the dashboard and find the Mac mini remote desktop in the Address book
73-
- Open the remote desktop with the username and password (found in the console)
74-
75-
- **Devolutions Remote Desktop Manager:**
76-
- Download [Devolutions Remote Desktop Manager](https://devolutions.net/remote-desktop-manager/)
77-
- Download .NET Desktop Runtime if needed
78-
- Open Remote Desktop Manager
79-
- Click **+** and **New Entry**
80-
- Choose **ARD**
81-
- 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).
82-
- Open the session
83-
84-
</TabsTab>
85-
<TabsTab label="Linux">
86-
If your local machine runs Linux, you will need to install a remote desktop client to access the remote desktop of the Mac mini.
87-
88-
1. Click **Apple silicon** in the **Bare Metal** section of the side menu. A list of your Mac minis displays.
89-
<Lightbox src="scaleway-apple-silicon-dashboard.webp" alt="Scaleway Apple Silicon Dashboard" />
90-
2. Click the Mac mini you want to connect to. The **Overview** page of your Mac mini displays.
91-
3. Configure your remote desktop client for the connection. We suggest using one of these two remote desktop clients:
92-
- **Remmina:**
93-
- [Download and install Remmina](https://remmina.org/), if necessary.
94-
<Message type="tip">
95-
Remmina is included in most Linux distributions by default.
96-
</Message>
97-
- Open Remmina and click the **+** icon in the top left to create a new quick connection.
98-
- Enter the following parameters:
99-
- **Protocol**: Remmina VNC Plugin
100-
- **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`).
101-
- **Username**: The remote desktop password of your Mac mini, available on its **Overview** page in the Scaleway console.
102-
- **Password**: The remote desktop password of your Mac mini, displayed on its **Overview** page in the Scaleway console.
103-
- **Color depth**: High color (16 bpp) or better, otherwise the connection will fail.
104-
- Click **Save and connect** to save these settings for future use and launch a connection to your Mac mini.
105-
- You can now log in to the graphical environment of macOS using the user and the remote desktop password displayed in your Scaleway console.
106-
<Message type="tip">
107-
Once Remmina is installed and set up, you can connect to the remote desktop directly by clicking the **remote desktop** button in the console.
108-
</Message>
109-
110-
- **Devolutions Remote Desktop Manager:**
111-
- Download [Devolutions Remote Desktop Manager](https://devolutions.net/remote-desktop-manager/)
112-
- Download .NET Desktop Runtime if needed
113-
- Open Remote Desktop Manager
114-
- Click **+** and **New Entry**
115-
- Choose **ARD**
116-
- 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).
117-
- Open the session
118-
</TabsTab>
119-
</Tabs>
35+
<Concept>
36+
37+
## Accessing the remote desktop from a macOS client
38+
39+
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.
40+
41+
1. Click **Apple silicon** in the **Bare Metal** section of the side menu. A list of your Mac minis displays.
42+
<Lightbox src="scaleway-apple-silicon-dashboard.webp" alt="Scaleway Apple Silicon Dashboard" />
43+
2. Click the Mac mini you want to connect to. The **Overview** page of your Mac mini displays.
44+
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.
45+
<Lightbox src="scaleway-apple-silicon-remote-desktop.webp" alt="Scaleway Apple Silicon remote desktop selector" />
46+
47+
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).
48+
49+
<Message type="note">
50+
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.
51+
</Message>
52+
53+
You are now logged in and can use your Mac mini as if you were physically present.
54+
55+
<Lightbox src="scaleway-m1-remote-desktop.webp" alt="Scaleway remote desktop" />
56+
</Concept>
57+
58+
<Concept>
59+
60+
## Accessing the remote desktop from a Windows client
61+
62+
If your local machine runs Windows, you will need to install a remote desktop client to access the remote desktop of the Mac mini.
63+
64+
1. Click **Apple silicon** in the **Bare Metal** section of the side menu. A list of your Mac minis displays.
65+
<Lightbox src="scaleway-apple-silicon-dashboard.webp" alt="Scaleway Apple Silicon Dashboard" />
66+
2. Click the Mac mini you want to connect to. The **Overview** page of your Mac mini displays.
67+
3. Configure your remote desktop client for Windows for the connection. We suggest using one of these two remote desktop clients:
68+
<Message type="note">
69+
These clients are free versions of commercially supported solutions and may have usage restrictions.
70+
</Message>
71+
72+
- **RealVNC:**
73+
- Download [RealVNC Viewer](https://www.realvnc.com/en/connect/download/viewer/)
74+
- Open RealVNC Viewer (no sign-in required)
75+
- Click **File** and **New Connection**
76+
- 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.
77+
- Go back to the dashboard and find the Mac mini remote desktop in the Address book
78+
- Open the remote desktop with the username and password (found in the console)
79+
80+
- **Devolutions Remote Desktop Manager:**
81+
- Download [Devolutions Remote Desktop Manager](https://devolutions.net/remote-desktop-manager/)
82+
- Download .NET Desktop Runtime if needed
83+
- Open Remote Desktop Manager
84+
- Click **+** and **New Entry**
85+
- Choose **ARD**
86+
- 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).
87+
- Open the session
88+
89+
</Concept>
90+
91+
<Concept>
92+
93+
## Accessing the remote desktop from a Linux client
94+
95+
If your local machine runs Linux, you will need to install a remote desktop client to access the remote desktop of the Mac mini.
96+
97+
1. Click **Apple silicon** in the **Bare Metal** section of the side menu. A list of your Mac minis displays.
98+
<Lightbox src="scaleway-apple-silicon-dashboard.webp" alt="Scaleway Apple Silicon Dashboard" />
99+
2. Click the Mac mini you want to connect to. The **Overview** page of your Mac mini displays.
100+
3. Configure your remote desktop client for the connection. We suggest using one of these two remote desktop clients:
101+
- **Remmina:**
102+
- [Download and install Remmina](https://remmina.org/), if necessary.
103+
<Message type="tip">
104+
Remmina is included in most Linux distributions by default.
105+
</Message>
106+
- Open Remmina and click the **+** icon in the top left to create a new quick connection.
107+
- Enter the following parameters:
108+
- **Protocol**: Remmina VNC Plugin
109+
- **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`).
110+
- **Username**: The remote desktop password of your Mac mini, available on its **Overview** page in the Scaleway console.
111+
- **Password**: The remote desktop password of your Mac mini, displayed on its **Overview** page in the Scaleway console.
112+
- **Color depth**: High color (16 bpp) or better, otherwise the connection will fail.
113+
- Click **Save and connect** to save these settings for future use and launch a connection to your Mac mini.
114+
- You can now log in to the graphical environment of macOS using the user and the remote desktop password displayed in your Scaleway console.
115+
<Message type="tip">
116+
Once Remmina is installed and set up, you can connect to the remote desktop directly by clicking the **remote desktop** button in the console.
117+
</Message>
118+
119+
- **Devolutions Remote Desktop Manager:**
120+
- Download [Devolutions Remote Desktop Manager](https://devolutions.net/remote-desktop-manager/)
121+
- Download .NET Desktop Runtime if needed
122+
- Open Remote Desktop Manager
123+
- Click **+** and **New Entry**
124+
- Choose **ARD**
125+
- 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).
126+
- Open the session
127+
128+
</Concept>
129+
130+
<Concept>
131+
132+
## Comparison matrix of remote desktop clients
133+
134+
Below is a matrix to compare the different features of the free versions of these remote desktop clients:
135+
136+
| Client | Compatible OS | Copy & Paste | Streaming Audio<sup>*</sup> | Security/Tunneling Mode | High Quality Compatibility | Display Responsiveness |
137+
|---------------------------------|---------------|--------------------------------------------|--------------------------|--------------------------------------------------|----------------------------|------------------------|
138+
| ARD (integrated) | macOS | ✅ (except for password) || ✅ auto | ⭐⭐⭐ | ⭐⭐⭐ |
139+
| RealVNC | Windows, Linux, macOS | 〰️ (some issues) | ❌ (not with free version) | ❌ (manual tunnel) || ⭐ (not recommended) |
140+
| Remmina | Linux | ✅ (manual, only from local to server) || ❌ (manual tunnel) |||
141+
| Devolutions Remote Desktop Manager | Windows, Linux, macOS ||| ✅ (requires additional setup - SSH tunnel) || ⭐⭐ |
142+
143+
<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 setting up another VNC connection and using this remote desktop client before configuring Reemo.
144+
145+
</Concept>
120146

121147
<Message type="tip">
122148
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/).
123149
</Message>
124150

125-
### Comparison matrix of remote desktop clients
126-
127-
Below is a matrix to compare the different features of the free versions of these remote desktop clients:
128-
129-
| Client | Compatible OS | Copy & Paste | Streaming Audio<sup>*</sup> | Security/Tunneling Mode | High Quality Compatibility | Display Responsiveness |
130-
|---------------------------------|---------------|--------------------------------------------|--------------------------|--------------------------------------------------|----------------------------|------------------------|
131-
| ARD (integrated) | macOS | ✅ (except for password) || ✅ auto | ⭐⭐⭐ | ⭐⭐⭐ |
132-
| RealVNC | Windows, Linux, macOS | 〰️ (some issues) | ❌ (not with free version) | ❌ (manual tunnel) || ⭐ (not recommended) |
133-
| Remmina | Linux | ✅ (manual, only from local to server) || ❌ (manual tunnel) |||
134-
| Devolutions Remote Desktop Manager | Windows, Linux, macOS ||| ✅ (requires additional setup - SSH tunnel) || ⭐⭐ |
135-
136-
<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.
137-
138151
<Message type="note">
139152
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.
140153
</Message>

0 commit comments

Comments
 (0)