feat(aps): add port information for vnc connections (#3927)

Author: bene2k1

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

@@ -26,6 +26,12 @@ The VNC protocol is platform-independent, supporting Linux, Windows, and macOS,
 - A [Mac mini](/bare-metal/apple-silicon/how-to/create-mac-mini/)
 
 ## 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.
+  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.
@@ -62,7 +68,7 @@ The VNC protocol is platform-independent, supporting Linux, Windows, and macOS,
           - Download [RealVNC Viewer](https://www.realvnc.com/en/connect/download/viewer/)
           - Open RealVNC Viewer (no sign-in required)
           - Click **File** and **New Connection**
-          - Enter the IP address of the Mac mini in the "VNC server" field and create the 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)
 
@@ -72,7 +78,7 @@ The VNC protocol is platform-independent, supporting Linux, Windows, and macOS,
           - Open Remote Desktop Manager
           - Click **+** and **New Entry**
           - Choose **ARD**
-          - Enter the IP address of the Mac mini in the "Host" field, the username, and the password (found in the console)
+          - 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>
@@ -91,7 +97,7 @@ The VNC protocol is platform-independent, supporting Linux, Windows, and macOS,
           - 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**: The public IP address of your Mac mini, found 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.
@@ -107,7 +113,7 @@ The VNC protocol is platform-independent, supporting Linux, Windows, and macOS,
           - Open Remote Desktop Manager
           - Click **+** and **New Entry**
           - Choose **ARD**
-          - Enter the IP address of the Mac mini in the "Host" field, the username, and the password (found in the console)
+          - 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>

bare-metal/apple-silicon/quickstart.mdx

@@ -51,6 +51,11 @@ You can access your Mac mini using VNC, a remote desktop-sharing protocol. It al
 
 Refer to our detailed documentation for Windows, Linux, and macOS for OS specific information: [How to access the remote desktop of a Mac mini](/bare-metal/apple-silicon/how-to/access-remote-desktop-mac-mini/).
 
+<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.
+  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>
+
 ## How to connect using SSH
 
 1. Navigate to the [Scaleway console](https://console.scaleway.com) and log in with your credentials.

bare-metal/apple-silicon/troubleshooting/cant-connect-using-vnc.mdx

@@ -47,13 +47,18 @@ round-trip min/avg/max/stddev = 0.182/0.207/0.261/0.028 ms
 
 ## 2. Verify the VNC connection
 
+<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.
+  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>
+
 Execute the following command in a terminal on your local machine:
 ```sh
-nc -zv <server_ip> 5900
+nc -zv <server_ip> <vnc_port>
 ```
 Expected output:
 ```
-Connection to <server_ip> port 5900 [tcp/rfb] succeeded!
+Connection to <server_ip> port <vnc_port> [tcp/rfb] succeeded!
 ```
 - If the connection fails, try [rebooting the server](/bare-metal/apple-silicon/how-to/reboot-mac-mini/).
 - If necessary, restart screen sharing via SSH. See [Restarting screen sharing via SSH](#restarting-screen-sharing-via-ssh).