Parra CLI Installation Guide
This guide explains how to install, update, and uninstall the Parra CLI on macOS. While the recommended installation method is via the Homebrew package manager, you may also choose to build it from source.
System Requirements
- A Mac running macOS Sonoma 14 or later.
- Xcode 15.3 or greater or later
- An iOS 17.4 Simulator runtime environment or later
Installing via Homebrew
If you haven't installed Homebrew yet, follow the instructions on the Homebrew website to get started.
Installation Steps
- Update Homebrew: Ensure your Homebrew is up to date by running:
brew update - Install Parra CLI: Install the Parra CLI using the following command:
brew install parra-inc/tap/parra-cli - Verify Installation: Confirm that the Parra CLI is correctly installed by running:
parra --version
Installing Updates
The Parra CLI relies on the system keychain to store session information. Since the parra executable's checksum changes between updates, it means you will be prompted to confirm permission to access existing keychain information. The Parra CLI will only access keychain information that it previously stored.
- Update Homebrew: First, make sure your Homebrew formulae are current:
brew update - Upgrade Parra CLI: To update the Parra CLI to the latest version, run:
brew upgrade parra-cli
Uninstalling
-
Uninstall the CLI: Remove the Parra CLI by executing:
brew uninstall parra-cli -
Remove the Tap: If you no longer need the Parra tap, remove it with:
brew untap parra-inc/tap
Building from Source
For those who prefer to build the Parra CLI from source, follow the development instructions provided in the Parra Mobile SDKs repository.
Dependencies
The Parra CLI is designed to encapsulate as much functionality as possible within a standalone binary, minimizing the need for external dependencies. However, in a few instances, dependencies are necessary. When using the CLI, you may be prompted to install the following Homebrew formulae if they aren't already available on your system.