From 7d9a441aa6e9d6fc7af61ecbfb5a7b4732b4da14 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Fri, 31 Jan 2025 16:53:42 +0100 Subject: [PATCH] feat(aps): rework troubleshooting --- .../cant-connect-using-ssh.mdx | 67 ++++-- .../cant-connect-using-vnc.mdx | 199 +++++++----------- .../cant-create-apple-account.mdx | 62 +++--- .../filevault-preventing-system-boot.mdx | 59 +++++- .../troubleshooting/mac-mini-inaccessible.mdx | 44 ++++ .../mac-mini-installation-issues.mdx | 44 ++++ 6 files changed, 297 insertions(+), 178 deletions(-) create mode 100644 pages/apple-silicon/troubleshooting/mac-mini-inaccessible.mdx create mode 100644 pages/apple-silicon/troubleshooting/mac-mini-installation-issues.mdx diff --git a/pages/apple-silicon/troubleshooting/cant-connect-using-ssh.mdx b/pages/apple-silicon/troubleshooting/cant-connect-using-ssh.mdx index 7cf62097a8..14ec1bb4bb 100644 --- a/pages/apple-silicon/troubleshooting/cant-connect-using-ssh.mdx +++ b/pages/apple-silicon/troubleshooting/cant-connect-using-ssh.mdx @@ -1,38 +1,63 @@ --- meta: - title: Resolving SSH connection issues to Scaleway Mac mini - description: Learn how to fix SSH connection problems with Scaleway Apple silicon Mac mini by uploading your SSH key and rebooting the device. + title: Resolving SSH connection issues to Scaleway Mac mini servers + description: Learn how to fix SSH connection problems with Scaleway Apple Silicon Mac mini by uploading your SSH key and rebooting the device. content: - h1: Resolving SSH connection issues to Scaleway Mac mini - paragraph: Learn how to fix SSH connection problems with Scaleway Apple silicon Mac mini by uploading your SSH key and rebooting the device. + h1: Resolving SSH connection issues to Scaleway Mac mini servers + paragraph: Learn how to fix SSH connection problems with Scaleway Apple Silicon Mac mini by uploading your SSH key and rebooting the device. tags: ssh ssh-key connection dates: - validation: 2024-12-19 + validation: 2025-01-30 posted: 2024-06-12 categories: - bare-metal --- -This documentation addresses an issue faced by users who are unable to connect to their Mac Mini via SSH. -This problem typically arises because the user's SSH key has not been uploaded to the Mac Mini. -It can also happen after multiple authentication failures while trying to access the VNC server because of default fail2ban security policies. -This guide provides the necessary steps to resolve this issue by connecting to the Scaleway console and rebooting the Mac Mini from the Apple silicon section. - - -The reboot **must** be carried out via the console, and not via any other method, in order to resolve the problem. - - - - A Scaleway account logged into the [console](https://console.scaleway.com) - [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization - An [SSH key](/organizations-and-projects/how-to/create-ssh-key/) - A [Mac mini](/apple-silicon/how-to/create-mac-mini/) -1. Click **Apple silicon** in the **Bare Metal** section of the side menu. A list of your Mac minis displays. -2. Click the Mac mini you want to configure. Your Mac mini information page displays. -3. Scroll down to the **Reboot Mac mini** section. Click **Reboot** to reboot the Mac mini. - - Ensure you have [generated and uploaded your SSH key](/organizations-and-projects/how-to/create-ssh-key/) before rebooting your Mac mini. +## Problem +You are unable to connect to your Scaleway Mac mini via SSH. + +### Symptoms +- SSH connection attempts fail. +- "Permission denied" or "Connection refused" errors appear. +- Timeouts occur when trying to establish an SSH connection. + +### Possible causes +- The SSH key was not uploaded during the Mac mini setup. +- Your IP has been blacklisted due to multiple failed authentication attempts. +- The Mac mini requires a reboot to apply SSH key changes. + +### Solution + +#### Verify your SSH key +Ensure your SSH key is correctly configured before attempting to connect: +- Follow the instructions to [generate and upload an SSH key](/organizations-and-projects/how-to/create-ssh-key/). + +#### Check for connection blacklisting +Repeated failed login attempts can trigger Scaleway’s security mechanisms, blocking your connection. To resolve this: +- [Reboot](/apple-silicon/how-to/reboot-mac-mini/) your Mac mini to reset the `fail2ban` security measures. + A reboot ensures your SSH key is applied correctly and clears blacklisted IPs. + 1. Log in to the [Scaleway console](https://console.scaleway.com). + 2. Click **Apple Silicon** in the **Bare Metal** section of the side menu. + 3. Select your Mac mini from the list. + 4. Scroll down to the **Reboot Mac mini** section and click **Reboot**. + 5. Confirm the reboot. + + + The reboot **must** be carried out via the Scaleway console, and not via any other method, in order to resolve the problem. -4. Click **Reboot Mac mini** to confirm. The Mac mini reboots and your SSH key will be uploaded during the boot process. Banned host lists are reset as well. \ No newline at end of file + +#### Attempt SSH connection again +After the reboot, attempt to reconnect using: +```sh +ssh -i /path/to/your/private_key user@ +``` +Replace `/path/to/your/private_key` with your actual private key location and `` with your Mac mini’s IP address. + +## Further troubleshooting + If the issue persists, contact [Scaleway's support](https://console.scaleway.com/support) for Further troubleshooting. diff --git a/pages/apple-silicon/troubleshooting/cant-connect-using-vnc.mdx b/pages/apple-silicon/troubleshooting/cant-connect-using-vnc.mdx index a49cb469db..6cd4c00887 100644 --- a/pages/apple-silicon/troubleshooting/cant-connect-using-vnc.mdx +++ b/pages/apple-silicon/troubleshooting/cant-connect-using-vnc.mdx @@ -1,158 +1,111 @@ --- meta: - title: Troubleshooting remote desktop connections to Mac mini servers - description: This page suggests solutions for when you cannot establish a remote desktop connection to your Mac mini + title: Troubleshooting Remote Desktop connections to Mac mini servers + description: This page provides solutions for when you cannot establish a remote desktop connection to your Mac mini. content: - h1: Troubleshooting remote desktop connections to Mac mini servers - paragraph: This page suggests solutions for when you cannot establish a remote desktop connection to your Mac mini + h1: Troubleshooting Remote Desktop connections to Mac mini servers + paragraph: This page provides solutions for when you cannot establish a remote desktop connection to your Mac mini. tags: remote vnc connection apple-silicon error dates: - validation: 2024-12-19 + validation: 2025-01-30 posted: 2023-04-07 categories: - bare-metal --- -This documentation provides a structured approach to diagnose and resolve issues when you cannot establish a remote desktop connection to your Mac mini. - - - A Scaleway account logged into the [console](https://console.scaleway.com) - [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization +- An [SSH key](/organizations-and-projects/how-to/create-ssh-key/) - A [Mac mini](/apple-silicon/how-to/create-mac-mini/) -## 1. Verify the server status +## Problem +You are unable to establish a remote desktop (VNC) connection to your Scaleway Mac mini. + +### Symptoms +- VNC client fails to connect to the Mac mini. +- Authentication errors occur during connection attempts. +- Connection times out or is refused. +- Mac mini appears unreachable. + +### Possible causes +- The Mac mini is powered off or unresponsive. +- The VNC port assigned during system setup is incorrect. +- The SSH server is unresponsive. +- Your connection is blacklisted due to failed attempts. +- Incorrect credentials are being used. +- Remote connection client compatibility issues. + +### Steps to resolve -Execute the following `ping` command in a terminal on your local machine: +#### Verify the server status +Run the following command in a terminal: ```sh ping -c 5 ``` -Expected output: -``` -PING X.X.X.X (X.X.X.X): 56 data bytes -64 bytes from X.X.X.X: icmp_seq=0 ttl=64 time=0.182 ms -64 bytes from X.X.X.X: icmp_seq=1 ttl=64 time=0.261 ms -64 bytes from X.X.X.X: icmp_seq=2 ttl=64 time=0.191 ms -64 bytes from X.X.X.X: icmp_seq=3 ttl=64 time=0.200 ms -64 bytes from X.X.X.X: icmp_seq=4 ttl=64 time=0.201 ms - ---- X.X.X.X ping statistics --- -5 packets transmitted, 5 packets received, 0.0% packet loss -round-trip min/avg/max/stddev = 0.182/0.207/0.261/0.028 ms -``` -- If `ping` fails, try [rebooting the server](/apple-silicon/how-to/reboot-mac-mini/). -- If rebooting fails or if the server was forced to shut down, wait 24 hours for automatic restart. See [How to shutdown a Mac mini](/apple-silicon/how-to/shutdown-mac-mini/) for more information. +If `ping` fails: +- Try [rebooting the server](/apple-silicon/how-to/reboot-mac-mini/). +- If the server was forced to shut down, wait 24 hours for automatic restart. -## 2. Verify the VNC connection - - - 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. - - -Execute the following command in a terminal on your local machine: +#### Verify the VNC connection +Run the following command: ```sh nc -zv ``` -Expected output: -``` -Connection to port [tcp/rfb] succeeded! -``` -- If the connection fails, try [rebooting the server](/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). +If the connection fails: +- Verify the correct VNC port in the **Overview** section of your Scaleway console. +- [Reboot the server](/apple-silicon/how-to/reboot-mac-mini/). +- Restart screen sharing via SSH (see below). -## 3. Verify the SSH server response -Execute the following command: +#### Verify the SSH server response +Run the command: ```sh nc -zv 22 ``` -Expected output: -``` -Connection to port 22 [tcp/ssh] succeeded! -``` -- If the connection fails, try [rebooting the server](/apple-silicon/how-to/reboot-mac-mini/). - -## 4. Check for connection blacklisting -If VNC connection attempts repeatedly fail, the connection might be blacklisted, or the Apple screen sharing service might be unresponsive. - -- [Reboot the server](/apple-silicon/how-to/reboot-mac-mini/) to clear the `fail2ban` table. - -## 5. Verify your connection credentials +If the connection fails, [reboot the server](/apple-silicon/how-to/reboot-mac-mini/). -### Remote desktop (VNC) credentials -- Ensure the correct username and password are used. These can be verified in the console. -- For errors like "Authentication failed," verify credentials and retry. +#### Check for connection blacklisting +If VNC connection attempts fail repeatedly, your connection may be blacklisted. [Rebooting](/apple-silicon/how-to/reboot-mac-mini/) clears the `fail2ban` table. -### SSH keys -- Ensure the SSH key is correctly formatted and configured before installing the Mac. -- SSH keys provided post-installation are not considered. +#### Verify your connection credentials +- VNC: Ensure correct username and password. +- SSH: Ensure your SSH key was provided before installation. -## 6. Verify remote connection client compatibility -Ensure your remote connection client is compatible with macOS. Incompatible remote desktop (VNC) clients can cause failed connection attempts. For recommended VNC clients, see [How to access to the remote desktop of a Mac mini](/apple-silicon/how-to/access-remote-desktop-mac-mini/#comparison-matrix-of-remote-desktop-clients). +#### Verify remote access client compatibility +Use a compatible VNC client. See [this guide](/apple-silicon/how-to/access-remote-desktop-mac-mini/#comparison-matrix-of-remote-desktop-clients) for recommendations. -## 7. Reinstall the Mac mini - -If the previous attempts to resolve connection issues to your Mac mini have been unsuccessful, you may need to reinstall your server from the Scaleway console. - -Follow these steps to reinstall macOS on your Mac mini: - -1. Log in to your Scaleway console. -2. Navigate to your Mac mini server. -3. Select the option to reinstall a version of macOS. +#### Reinstall the Mac mini +If all else fails, [reinstall macOS](/apple-silicon/how-to/reinstall-mac-mini/) via the Scaleway console. + + Reinstalling your Mac mini will delete all data on it's disk. Ensure you have a backup of your data before launching any reinstallation. + -For detailed instructions, refer to [How to reinstall a Mac mini](/apple-silicon/how-to/reinstall-mac-mini/). +## Advanced configuration and security - - Reinstalling your Mac mini will erase all data on the disk and reset all configurations to default settings. Ensure you have a backup of your data before proceeding. - - -## Security and configuration - -### Enable and configure pf (Packet Filter) -To restrict macOS Screen Sharing to specific IPs: -1. Connect to your Mac mini via SSH: - ```sh - ssh@ - ``` -2. Backup the `pf.conf` file: - ```sh - sudo cp /etc/pf.conf /etc/pf.conf.backup - ``` -3. Edit the `pf.conf` file: - ```sh - sudo nano /etc/pf.conf - ``` -4. Add rules to restrict access: - ```sh - ## Add these lines to block connections to port 5900 except from your static IP - block in on en0 proto tcp from any to any port 5900 - pass in on en0 proto tcp from to any port 5900 - ``` - Replace `en0` with your network interface and `` with the allowed IP address. -5. Save and close the file. -6. Apply the new configuration: - ```sh - sudo pfctl -f /etc/pf.conf - ``` -7. Test the screen sharing connection from the allowed IP and verify it is blocked from other IPs. - - - For advanced configuration and further information consult our [fail2ban tutorial](/tutorials/protect-server-fail2ban/). - +### Enabling and configuring Packet Filter (pf) +To restrict access to Screen Sharing: +```sh +sudo nano /etc/pf.conf +``` +Add: +```sh +block in on en0 proto tcp from any to any port 5900 +pass in on en0 proto tcp from to any port 5900 +``` +Apply: +```sh +sudo pfctl -f /etc/pf.conf +``` ### Restarting screen sharing via SSH -If screen sharing is unresponsive, restart it via SSH: -1. Connect to your Mac mini via SSH: - ```sh - ssh your_mac_mini_username@ - ``` - - Replace `` with your Mac mini username. - - Replace `` with the actual IP address of your Mac mini. -2. Restart the screen sharing daemon: - ```sh - sudo killall screensharingd - ``` - The service will restart automatically upon the next connection attempt. - -## Troubleshooting and support -For further assistance, visit our #apple-silicon channel in the [Slack Community](https://slack.scaleway.com/). +1. Connect via SSH: +```sh +ssh your_mac_mini_username@ +``` +2. Restart screen sharing: +```sh +sudo killall screensharingd +``` + +## Further troubleshooting +If the issue persists, contact [Scaleway's support](https://console.scaleway.com/support) for Further troubleshooting. diff --git a/pages/apple-silicon/troubleshooting/cant-create-apple-account.mdx b/pages/apple-silicon/troubleshooting/cant-create-apple-account.mdx index a303f3369d..589efbb1ea 100644 --- a/pages/apple-silicon/troubleshooting/cant-create-apple-account.mdx +++ b/pages/apple-silicon/troubleshooting/cant-create-apple-account.mdx @@ -7,44 +7,58 @@ content: paragraph: This page suggests solutions for when you cannot create an Apple Account directly from your hosted Mac mini tags: apple-id apple account creation issues dates: - validation: 2024-10-24 + validation: 2025-01-30 posted: 2024-10-24 categories: - bare-metal --- + + An Apple Account is required for accessing Apple services such as the App Store, iCloud, iMessage, FaceTime, and more. It serves as a unique account used to authenticate your identity and connect you to the Apple ecosystem. -However, you might encounter issues creating an Apple Account directly from your hosted Mac mini, especially if too many Apple Accounts have already been created on it. +## Problem +You are unable to create an Apple Account directly from your hosted Mac mini. -Apple has implemented [a limit on the number of Apple Accounts](https://support.apple.com/en-us/101661) that can be created from a single device. If you are unable to create an Apple Account on your Mac mini due to this restriction, you can still create one through the Apple website and then sign in on your machine. +### Symptoms: +- An error message appears when trying to create an Apple Account. +- The system prevents you from proceeding with account creation. +- The error "Too many Apple Accounts created on this device" is displayed. -### Creating an Apple Account via the Apple website +### Possible causes: +- Apple limits the number of Apple Accounts that can be created on a single device. +- Restrictions on hosted Mac minis may prevent direct account creation. +- Temporary connectivity issues may block the account creation process. -If you are unable to create an Apple Account on your hosted Mac mini, follow these steps to create one through the Apple website: +### Solution -1. Open your web browser and navigate to the Apple Account creation page: [https://account.apple.com/account](https://account.apple.com/account). -2. Click **Create Your Apple Account**. You will be redirected to a page where you can start the registration process. -3. Fill in your personal information: - - First and Last Name: Enter your full name. - - Country/Region: Select your country or region from the dropdown menu. - - Birthdate: Enter your date of birth. - - Email Address: Enter your existing email address. This will be your new Apple Account. - - Password: Create a strong and secure password for your account. - - Phone number: Enter your phone number. It will be used for two factor authentication and account recovery. - Verify your information and click **Continue** to proceed. - Apple will send a verification email to the address you provided. - 4. Open the email and follow the instructions to verify your account. -5. After verification, agree to Apple's terms and conditions to complete the process. Tick the checkbox and click on the corresponding button to agree. -6. Return to your hosted Mac mini and sign in using your new credentials, having successfully created your Apple Account. +#### Create an Apple Account via the Apple website +If your hosted Mac mini prevents you from creating an Apple Account, use the Apple website instead: + +1. Open a web browser and visit [Apple's Account Creation Page](https://account.apple.com/account). +2. Click **Create Your Apple Account**. +3. Fill in the required personal details: + - **First and Last Name**: Enter your full name. + - **Country/Region**: Select your country or region. + - **Birthdate**: Enter your date of birth. + - **Email Address**: Provide an existing email to use as your Apple ID. + - **Password**: Choose a secure password. + - **Phone Number**: Enter a valid phone number for two-factor authentication. +4. Verify your details and click **Continue**. +5. Check your email for a verification link from Apple and follow the instructions to confirm your account. +6. Accept Apple’s terms and conditions. +7. Sign in to your hosted Mac mini using your newly created Apple Account. - The information provided above is for reference only. For detailed instructions or if you encounter any issues while creating your Apple Account, refer to [Apple's official documentation](https://support.apple.com/en-us/108647) on how to create a new Apple Account. +For further guidance, refer to [Apple's official documentation](https://support.apple.com/en-us/108647) on account creation. -### Further troubleshooting +## Troubleshoot further issues +- If you see "Too many Apple Accounts created on this device," you must create the account from another device or browser. +- If you face errors when signing in after creating an account, try signing in from another device first, then use the credentials on your hosted Mac mini. +- For persistent issues, visit [Apple Support](https://support.apple.com/) for additional troubleshooting. + +#### Contact Apple support +If the problem continues despite following the steps above, reach out to [Apple Support](https://support.apple.com/) for direct assistance. -- If you encounter errors while creating an Apple Account on your hosted Mac mini (e.g., "Too many Apple Accounts created on this device"), use the method described above to create your Apple Account through the website. -- If the problem persists after creating your Apple Account on the website, try signing in from a different device or contact [Apple Support](https://support.apple.com/) for further assistance. -- For more details, you can visit [Apple's Support Page](https://support.apple.com/en-us/108647) on Apple Accounts. diff --git a/pages/apple-silicon/troubleshooting/filevault-preventing-system-boot.mdx b/pages/apple-silicon/troubleshooting/filevault-preventing-system-boot.mdx index 3d555d0638..2dbc291e16 100644 --- a/pages/apple-silicon/troubleshooting/filevault-preventing-system-boot.mdx +++ b/pages/apple-silicon/troubleshooting/filevault-preventing-system-boot.mdx @@ -1,28 +1,67 @@ --- meta: - title: I need to prevent FileVault from stopping my system from booting - description: This page explains how to prevent FileVault from stopping your system from booting + title: Preventing FileVault from blocking system boot + description: This page explains how to prevent FileVault from stopping your system from booting. content: - h1: I need to prevent FileVault from stopping my system from booting - paragraph: This page explains how to prevent FileVault from stopping your system from booting + h1: Preventing FileVault from blocking system boot + paragraph: This page explains how to prevent FileVault from stopping your system from booting. tags: filevault boot booting dates: - validation: 2024-12-19 + validation: 2025-01-30 posted: 2021-05-26 categories: - bare-metal --- - - A Scaleway account logged into the [console](https://console.scaleway.com) - [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization +- An [SSH key](/organizations-and-projects/how-to/create-ssh-key/) - A [Mac mini](/apple-silicon/how-to/create-mac-mini/) -Apple FileVault is a disk encryption feature. Ensure that FileVault is **not enabled** on your Mac mini. If enabled, it will prevent your system from booting. +## Problem +FileVault encryption is preventing your Mac mini from booting properly. + +### Symptoms +- The Mac mini does not complete the boot process. +- A FileVault password prompt appears at startup. +- Remote access via SSH or VNC is unavailable after a reboot. + +### Possible causes +- FileVault is enabled on the system disk. +- The Mac mini rebooted and requires a FileVault password to proceed. +- Remote access is blocked because the system is waiting for manual decryption. + +### Solution -To turn off FileVault, go to **System Preferences**, click on **Security**, followed by **FileVault**, then click the button that says **turn off FileVault**. +#### Verify if FileVault is enabled +To check FileVault status: +1. Open **System Preferences**. +2. Go to **Security & Privacy**. +3. Click the **FileVault** tab. +4. If FileVault is enabled, it will indicate that disk encryption is active. + +#### Disable FileVault to ensure boot continuity +1. Open **System Preferences**. +2. Click **Security & Privacy** > **FileVault**. +3. Click **Turn Off FileVault**. +4. Enter the administrator password if prompted. +5. Allow the decryption process to complete. + +#### Reboot and verify boot success +After turning off FileVault: +- Reboot your Mac mini and confirm that it starts up without requesting the FileVault password. +- Test remote access via SSH or VNC to ensure connectivity remains available. - If FileVault is enabled and your Mac mini reboots for whatever reason, it will ask for the FileVault password during the boot process, before you can access the machine using VNC or SSH. You will **not be able** to restart it or recover your data if FileVault is enabled. - \ No newline at end of file +If FileVault is enabled and your Mac mini reboots unexpectedly, you will be required to enter the FileVault password manually. Remote access will not be possible until the disk is unlocked, and you may risk data loss. + + +## Preventing future issues +To prevent FileVault from causing boot issues in the future: +- **Avoid enabling FileVault** on Scaleway Mac minis. +- **Use alternative encryption methods** that do not require manual intervention on reboot. +- **Ensure proper backups** before making changes to encryption settings. + +## Further troubleshooting +If the issue persists, contact [Scaleway's support](https://console.scaleway.com/support) for Further troubleshooting. diff --git a/pages/apple-silicon/troubleshooting/mac-mini-inaccessible.mdx b/pages/apple-silicon/troubleshooting/mac-mini-inaccessible.mdx new file mode 100644 index 0000000000..e02664c278 --- /dev/null +++ b/pages/apple-silicon/troubleshooting/mac-mini-inaccessible.mdx @@ -0,0 +1,44 @@ +--- +meta: + title: Resolving Inaccessibility Issues with Mac mini + description: Steps to troubleshoot and regain access to your Scaleway Apple Silicon Mac mini. +content: + h1: Resolving Inaccessibility Issues with Mac mini + paragraph: Steps to troubleshoot and regain access to your Scaleway Apple Silicon Mac mini. +tags: access, connectivity, mac-mini +dates: + validation: 2025-01-31 + posted: 2025-01-31 +categories: + - bare-metal +--- + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization +- An [SSH key](/organizations-and-projects/how-to/create-ssh-key/) +- A [Mac mini](/apple-silicon/how-to/create-mac-mini/) + +## Problem +My Mac mini is inaccessible. + +### Symptoms +Your Mac mini is inaccessible when you try to reach it on its IP address or hostname. + +## Possible causes: +- Network configuration errors. +- Firewall settings blocking access. +- System crashes or unresponsive states. + +### Solution: +1. Check the network configuration: + - Ensure that your Mac mini is correctly configured with the appropriate IP settings. + +2. Review firewall Settings: + - Verify that firewall settings are not blocking incoming connections. + +3. Reboot the Mac mini: + - Use the Scaleway console to reboot your Mac mini. + +4. Contact support: + - If the issue persists, contact [Scaleway support](https://console.scaleway.com/support) for Further troubleshooting. diff --git a/pages/apple-silicon/troubleshooting/mac-mini-installation-issues.mdx b/pages/apple-silicon/troubleshooting/mac-mini-installation-issues.mdx new file mode 100644 index 0000000000..5a7aa2d576 --- /dev/null +++ b/pages/apple-silicon/troubleshooting/mac-mini-installation-issues.mdx @@ -0,0 +1,44 @@ +--- +meta: + title: Troubleshooting Mac mini Installation Issues + description: Learn how to resolve common installation problems with Scaleway Apple Silicon Mac mini. +content: + h1: Troubleshooting Mac mini Installation Issues + paragraph: Learn how to resolve common installation problems with Scaleway Apple Silicon Mac mini. +tags: installation, setup, mac-mini +dates: + validation: 2025-01-31 + posted: 2025-01-31 +categories: + - bare-metal +--- + + +- A Scaleway account logged into the [console](https://console.scaleway.com) +- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization +- An [SSH key](/organizations-and-projects/how-to/create-ssh-key/) +- A [Mac mini](/apple-silicon/how-to/create-mac-mini/) + +## Problem +The installation of your Mac mini failed. + +### Symptoms +The installation of your hosted Mac mini could not complete successfully. + +### Possible causes: +- Incompatible installation image. +- Network interruptions during installation. +- Hardware compatibility issues. + +### Solution: +1. Verify installation image: + - Ensure that the installation image is not is compatible with your Mac mini version. If unsure try a different version and relaunch the installation process. + +2. Check network connectivity: + - Confirm that your network connection is stable throughout the installation process. + +3. Reinstall macOS: + - Navigate to the Scaleway console, select your Mac mini, and initiate a [reinstallation of macOS](/apple-silicon/how-to/reinstall-mac-mini/). + +4. Contact support: + - If issues persist, reach out to [Scaleway's support](https://console.scaleway.com/support) for Further troubleshooting.