Skip to main content

ARO Desktop Installation Guide

Supported Operating Systems​

ARO Desktop currently supports the following desktop operating systems:

  • macOS
  • Windows
  • Linux

macOS Installation Guide​

Step 1: Download the macOS Package from Dashboard​

  1. Go to Dashboard -> Add New Node.
  2. Choose macOS as your system.
  3. Download the .dmg installer.

Download DMG from Dashboard

Step 2: Install and Open ARO Desktop (Handle macOS Security Prompt)​

  1. Open the downloaded .dmg file.
  2. Drag the ARO Desktop app icon into Applications.
  3. Open Applications and launch ARO Desktop.
  4. You may see a macOS prompt saying the app cannot be opened.

This is expected in some environments because the app can be recognized as coming from an unidentified developer signature by macOS security checks.

Drag ARO Desktop to Applications

Allow ARO Desktop in Privacy & Security

  1. Open System Settings.
  2. Go to Privacy & Security.
  3. In the Security section, find the blocked message for ARO Desktop.
  4. Click Open Anyway.

Step 3: Start ARO Desktop and Get Node SN​

  1. Launch ARO Desktop again.
  2. You should now see the app startup screen.

ARO Desktop Startup Screen

  1. Click Start to run the node.
  2. The app will generate a Serial Number (SN).

Step 4: Bind the Node in Dashboard​

  1. Return to Dashboard -> Add New Node.
  2. Start the node-adding flow.
  3. Enter the generated SN and follow the on-screen instructions.
  4. Complete the first-time node binding.

Bind SN in Dashboard

Windows Installation Guide​

Step 1: Download the Windows Installer from Dashboard​

  1. Go to Dashboard -> Add New Node.
  2. Choose Windows as your system.
  3. Download the .exe installer.

Step 2: Run the Installer and Follow the Setup Wizard​

  1. Locate the downloaded .exe file and double-click to run it.
  2. Follow the installer wizard steps carefully.

Windows Installer Welcome

Windows Installation Step 2

Windows Installation Step 3

Windows Installation Step 4

Windows Installation Step 5

Windows Installation Complete

  1. Once the installation is complete, ARO Desktop will be ready to use.
Missing VCRUNTIME140_1.dll?

If you encounter an error message about VCRUNTIME140_1.dll not found during installation or when launching ARO Desktop, this indicates that your Windows system is missing a required C++ runtime dependency.

To resolve this issue:

  1. Visit the Microsoft Visual C++ Redistributable download page.
  2. Download the appropriate version for your system (x86 or x64).
  3. Install the downloaded Visual C++ Redistributable package.
  4. Restart your computer.
  5. Return to step 1 and re-run the ARO Desktop installer.

Step 3: Start ARO Desktop and Get Node SN​

  1. Launch ARO Desktop from your Start Menu or desktop shortcut.
  2. You should now see the app startup screen.

ARO Desktop Startup Screen

  1. Click Start to run the node.
  2. The app will generate a Serial Number (SN).

Step 4: Bind the Node in Dashboard​

  1. Return to Dashboard -> Add New Node.
  2. Start the node-adding flow.
  3. Enter the generated SN and follow the on-screen instructions.

Bind SN in Dashboard

Node Binding Confirmation

  1. Complete the first-time node binding.
  2. Your Windows ARO Desktop node is now ready to operate!

Linux Installation Guide​

ARO Desktop supports both Debian/Ubuntu-based and RPM-based (CentOS/RHEL) Linux systems.

Debian / Ubuntu​

Step 1: Download the Linux Package from Dashboard​

  1. Go to Dashboard -> Add New Node.
  2. Choose Linux as your system.
  3. Download the .deb installer.

Step 2: Install ARO Desktop​

sudo apt install ./ARO_Desktop_<version>_amd64.deb

Replace <version> with the actual filename you downloaded.

Step 3: Start ARO Desktop and Bind Your Node​

  1. Launch ARO Desktop.
  2. Click Start to run the node.
  3. The app will generate a Serial Number (SN).
  4. Go to Dashboard -> Add New Node.
  5. Enter the SN and complete the binding flow.

Uninstall (Debian / Ubuntu)​

sudo apt purge aro-desktop

CentOS​

Step 1: Download the Linux Package from Dashboard​

  1. Go to Dashboard -> Add New Node.
  2. Choose Linux as your system.
  3. Download the .rpm installer.

Step 2: Install ARO Desktop​

sudo dnf install -y ./ARO_Desktop-<version>-1.x86_64.rpm

Replace <version> with the actual filename you downloaded.

Missing dependencies?

If the installation fails due to missing packages (e.g. webkit2gtk4.1), enable EPEL and CRB first, then retry:

sudo dnf install -y epel-release
sudo dnf config-manager --set-enabled crb
sudo dnf install -y ./ARO_Desktop-<version>-1.x86_64.rpm

Step 3: Start ARO Desktop and Bind Your Node​

  1. Launch ARO Desktop.
  2. Click Start to run the node.
  3. The app will generate a Serial Number (SN).
  4. Go to Dashboard -> Add New Node.
  5. Enter the SN and complete the binding flow.

Uninstall (CentOS)​

sudo dnf remove aro-desktop

Troubleshooting​

Incomplete uninstall on Debian / Ubuntu​

If apt purge leaves residual package state, manually clean the dpkg status entry:

  1. Open the dpkg status file:
sudo nano /var/lib/dpkg/status

  1. Search for the aro-desktop block: press Ctrl + W, type aro-desktop, then press Enter.

  2. Delete the entire block starting from Package: aro-desktop through the end of that entry.

  3. Save and exit: Ctrl + O → Enter → Ctrl + X.

  4. Repair dpkg and fix broken packages:

sudo dpkg --configure -a
sudo apt --fix-broken install
  1. Refresh the desktop application database:
sudo update-desktop-database

Kill ARO Desktop process (if needed)​

pkill -f aro-desktop