fix(aps): reorg content

bene2k1 · bene2k1 · commit b375a4af5e68 · 2025-01-14T11:15:57.000+01:00
diff --git a/bare-metal/apple-silicon/how-to/access-remote-desktop-mac-mini.mdx b/bare-metal/apple-silicon/how-to/access-remote-desktop-mac-mini.mdx
@@ -7,7 +7,7 @@ content:
   paragraph: Learn how to access a Mac mini using remote desktop clients on macOS, Windows, and Linux.
 tags: apple-silicon, connection, mac-mini, mac-mini
 dates:
-  validation: 2024-07-22
+  validation: 2025-01-14
   posted: 2021-05-26
 categories:
   - bare-metal
@@ -28,77 +28,76 @@ The VNC protocol is platform-independent, supporting Linux, Windows, and macOS,
 ## Accessing the remote desktop
 
 <Message type="important">
-  The VNC port on Mac mini systems is **randomly assigned** during system installation and may therefore be different from the default VNC port 5900. To connect successfully via VNC, use the specific port shown in the **Overview** section of your Mac mini’s configuration.
+  The VNC port on Mac mini systems is **randomly assigned** during system installation and may therefore be different from the default VNC port. To connect successfully via VNC, use the specific port shown in the **Overview** section of your Mac mini’s configuration.
   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.
+### Accessing the remote desktop from a macOS 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" />
+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.
 
-        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).
+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" />
 
-        <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>
+  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).
 
-    You are now logged in and can use your Mac mini as if you were physically present.
+  <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>
 
-    <Lightbox src="scaleway-m1-remote-desktop.webp" alt="Scaleway remote desktop" />
+4. You are now logged in and can use your Mac mini as if you were physically present.
 
-  </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
+  <Lightbox src="scaleway-m1-remote-desktop.webp" alt="Scaleway remote desktop" />
+
+### 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).
 
-  </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. 
+    #### 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.
+
+### 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:**
+        #### 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.
+            - **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.
@@ -107,22 +106,16 @@ The VNC protocol is platform-independent, supporting Linux, Windows, and macOS,
                 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:**
+        #### 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**
+          - 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>
-
-<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>
+          - Open the session.
 
-### Comparison matrix of remote desktop clients
+## Comparison matrix of remote desktop clients
 
 Below is a matrix to compare the different features of the free versions of these remote desktop clients:
 
@@ -135,6 +128,10 @@ Below is a matrix to compare the different features of the free versions of thes
 
 <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="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>
+
 <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>
