Add existing device - select operating system -> Add existing device - MAC

Add existing device - MAC

Summary

This page guides you through connecting an existing Mac device to your account. You will name your device, receive instructions to install software on your Mac, copy a device ID, and then wait for the device to connect. Once successfully connected and configured, you will be redirected to the device's configuration page.

Page Access

You can access this page by navigating to: /connect_steps_existing?os=mac

Page Functionalities

Step 1: Set Device Name and Software Installation

This initial step allows you to give your Mac device a unique name within your account. You will see:

  • Device Name Input Field: Here, you type the name you wish to assign to your Mac device. The name must be at least 3 characters long.
  • Apple Icon: A visual indicator that you are configuring a Mac device.
  • Software Installation Commands: Two distinct command lines are provided. The first is to download the installer script to your Mac, and the second is to run it. You should copy these commands and paste them into your Mac's Terminal application. Each command has a convenient copy button next to it.
  • "Continue" Button: After entering a device name and starting the installation process on your Mac, click this button to proceed to the next step.
  • Error Message Area: If the device name you entered is too short or already in use, an error message will appear at the top of the page.

Step 2: Copy Device ID

After successfully setting a device name, this step displays a unique identifier for your device:

  • Device ID Display: A unique code representing your device is shown. You will need to copy this ID.
  • Copy Button: A button next to the Device ID allows you to easily copy it to your clipboard.
  • Instructions: Guidance on where to paste this Device ID in your Mac's Terminal (into the running installer script).
  • "Continue" Button: Once you have pasted the Device ID into your Mac's Terminal, click this button to move forward.

Step 3: Waiting for Device to Come Online

This step monitors your Mac device as it completes its setup and attempts to connect to your account:

  • Waiting Message: Displays "Waiting for device to come online..." to indicate the system is monitoring your device.
  • Progress Bar: A visual bar that fills up over time, showing that the system is actively waiting. This process can take up to 2 minutes.
  • Error Message Area: If the device fails to connect within the expected timeframe, an error message will appear, suggesting you double-check the installation.
  • "Try Again" Button: Appears if the device does not come online, allowing you to restart the waiting process.

Step 4: Device Connection Successful and Configuration

This final step confirms that your Mac device has successfully connected and is undergoing its final configuration:

  • Success Message: A banner confirming "Device connection successful" and displaying the name you assigned to your device.
  • Device Information: Shows basic details about your connected Mac, such as its local IP address and memory.
  • Configuration Progress: A second progress bar and messages indicating "Waiting for device configuration and installation" and "Usually takes 1-2 minutes." This step ensures all necessary software and settings are applied.
  • Automatic Redirection: Once the configuration is complete, the page will automatically redirect you to the device's dedicated configuration page.

Scenario Executions

Possible usage steps within this page

Scenario 1: Successful Device Connection

  1. Enter Device Name: In the "Set Device Name" step, type a unique name for your Mac (e.g., "MyMacBookPro").
  2. Install Software: Copy the provided curl command and paste it into your Mac's Terminal to download the installer script.
  3. Run Installer: Copy the chmod +x install.sh && ./install.sh command and paste it into your Mac's Terminal to run the installer.
  4. Continue to Device ID: Click the "Continue" button in the app.
  5. Copy and Paste Device ID: In the "Copy Device ID" step, copy the displayed Device ID from the app and paste it into the running installer in your Mac's Terminal.
  6. Continue to Waiting Screen: Click the "Continue" button in the app.
  7. Wait for Connection: The "Waiting for device to come online..." screen appears. The progress bar fills as the system monitors your device.
  8. Device Configuration: Once online, the "Device connection successful" screen appears, displaying device details and a progress bar for configuration.
  9. Automatic Redirection: The page automatically navigates to your device's configuration page after setup is complete.

Possible errors which may occur on this page

Error 1: Device Name Already In Use

This error occurs during the "Set Device Name" step if you enter a device name that is already registered under your account or by another user. The system requires each device to have a unique identifier. You will see an error message like "Device name is already in use - please use another one". To resolve this, simply enter a different, unique name for your device in the input field.

Error 2: Device Not Coming Online

This error occurs during the "Waiting for device to come online" step if your Mac device fails to report its online status within a specific timeframe (approximately 2 minutes). This often indicates an issue with the software installation on your Mac. An error message stating "Device is not online. Please double-check your installation." will appear. You should:

  1. Verify that the installer script completed successfully on your Mac's Terminal.
  2. Ensure your Mac has an active internet connection.
  3. Click the "Try Again" button in the app to restart the waiting process after resolving any installation issues.

Error 3: Short Device Name

During the "Set Device Name" step, if you enter a name shorter than three characters, an error message "At least 3 chars" will be displayed beneath the input field. To proceed, simply enter a device name that meets the minimum length requirement.

Up to User Manual Main Page