Installation Guide

Solo is available through popular package managers for macOS, Windows, and Linux. For environments where package managers are not preferred, portable binaries can be downloaded directly from GitHub.

Package Managers

The recommended way to install Solo is via your operating system’s package manager to ensure easy updates and system integration.

macOS

Solo is distributed for macOS via Homebrew.

1. Add the raml-dev custom TAP:

   brew tap raml-dev/tap

2. Install the Solo cask:

   brew install --cask raml-dev/tap/solo

3. Authorize execution: Since Solo is currently in early distribution, you must manually authorize the application. You can do this via the terminal:

   xattr -dr com.apple.quarantine /Applications/solo.app

   Alternatively, go to System Settings > Privacy & Security and allow the application to run.

   Quarantine

   If you skip this step, macOS will prevent the application from launching, reporting that the developer cannot be verified or that the app is damaged.

4. Launch: You can now start Solo from Launchpad or Spotlight.

Windows

On Windows, Solo is available via Scoop.

1. Add the raml-dev custom Scoop bucket:

   scoop bucket add raml-dev https://github.com/raml-dev/scoop-bucket

2. Install Solo:

   scoop install solo

   SmartScreen

   Windows may display a SmartScreen warning. Click “More info” and then select “Run anyway” to proceed.

Linux

Solo provides official repositories for the most common Linux package managers.

Debian / Ubuntu (APT)

1. Set up the repository:

   sudo install -d -m0755 /etc/apt/keyrings
   
   curl -fsSL https://linux-packages.raml.workers.dev/apt/raml-dev-archive-keyring.asc \
     | sudo gpg --dearmor -o /etc/apt/keyrings/raml-dev-archive-keyring.gpg
   
   echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/raml-dev-archive-keyring.gpg] https://linux-packages.raml.workers.dev/apt stable main" \
     | sudo tee /etc/apt/sources.list.d/raml-dev.list

2. Update and install:

   sudo apt update
   sudo apt install solo

Fedora / RHEL (DNF)

1. Add the repository:

   sudo curl -fsSL https://linux-packages.raml.workers.dev/rpm/raml-dev.repo \
     -o /etc/yum.repos.d/raml-dev.repo

2. Install Solo:

   sudo dnf install solo

Arch Linux (Pacman)

1. Register the repository:

   curl -fsSL https://linux-packages.raml.workers.dev/arch/raml-dev-pacman-key.asc \
     -o /tmp/raml-dev-pacman-key.asc
   
   sudo pacman-key --add /tmp/raml-dev-pacman-key.asc
   sudo pacman-key --lsign-key 'raml-dev Arch Repository'
   
   sudo tee -a /etc/pacman.conf >/dev/null <<'EOF'
   [raml-dev]
   SigLevel = Required
   Server = https://linux-packages.raml.workers.dev/arch/$arch
   EOF

2. Sync and install:

   sudo pacman -Suy solo

Standalone Binaries

Portable binaries are available for manual installation from GitHub Releases.

1. Download: Obtain the appropriate binary for your architecture (e.g.,solo-linux-amd64 or solo-windows-arm64.exe).

2. Permissions (Linux/macOS): Assign execution permissions via the terminal: bash chmod +x solo-linux-amd64

3. Launch: Execute the binary to start the application.

---

Update Management

By default, Solo checks for new versions on startup. This behavior can be managed in the App Behavior settings.

• Notifications: When an update is available, a notification banner will appear within the application.
• Changelog: You can review the release notes directly in the app before updating.