CLI installation

The Marathon Cloud CLI is the primary tool for interacting with the platform. It allows you to submit test runs, monitor progress, and retrieve reports from your terminal or CI/CD environment. The current release is 1.0.65; examples below use that version.

Quick start

brew tap malinskiy/tap && brew install malinskiy/tap/marathon-cloud

Installation methods

macOS

Homebrew (recommended)

brew tap malinskiy/tap
brew install malinskiy/tap/marathon-cloud

Manual download

Download the universal macOS archive from the releases page. It extracts into a versioned directory:

tar xzf marathon-cloud-v1.0.65-universal-apple-darwin.tar.gz
sudo mv marathon-cloud-v1.0.65-universal-apple-darwin/marathon-cloud /usr/local/bin/

Linux

Homebrew

brew tap malinskiy/tap
brew install malinskiy/tap/marathon-cloud

Manual download

Prebuilt binaries are available for amd64, arm64, armhf, and i686 in both gnu and musl variants. Download from the releases page, then:

The archive extracts into a versioned directory containing the binary, a man page, and shell completions.

tar xzf marathon-cloud-v1.0.65-x86_64-unknown-linux-musl.tar.gz
sudo mv marathon-cloud-v1.0.65-x86_64-unknown-linux-musl/marathon-cloud /usr/local/bin/

Debian/Ubuntu packages (.deb) are published for each release in both glibc (marathon-cloud_*.deb) and musl (marathon-cloud-musl_*.deb) variants:

sudo dpkg -i marathon-cloud_v*_amd64.deb

Docker

docker pull marathonlabs/marathon-cloud:latest
alias marathon-cloud='docker run -v "$(pwd)":/work -it --rm marathonlabs/marathon-cloud:latest'
marathon-cloud --help

The alias mounts your current directory so the CLI can access your APK/IPA files.

Windows

Download the Windows zip from the releases page and extract it. Add the directory containing marathon-cloud.exe to your system PATH.

Or use PowerShell. Assets are named marathon-cloud-v<version>-x86_64-pc-windows-msvc.zip (or i686 for 32-bit):

$version = "1.0.65"
Invoke-WebRequest -Uri "https://github.com/MarathonLabs/marathon-cloud-cli/releases/download/$version/marathon-cloud-v$version-x86_64-pc-windows-msvc.zip" -OutFile "marathon-cloud.zip"
Expand-Archive -Path "marathon-cloud.zip" -DestinationPath "."

Tip

Every release includes a checksums.txt file with SHA256 hashes for verifying download integrity.

Verify installation

marathon-cloud --version

Shell completions

Homebrew installs completions automatically. For manual installs:

Bash

source <(marathon-cloud completions bash)
echo 'source <(marathon-cloud completions bash)' >> ~/.bashrc

Zsh

source <(marathon-cloud completions zsh)

Fish

marathon-cloud completions fish | source

Update

Homebrew

brew update
brew upgrade marathon-cloud

Manual

Download the latest version from the releases page and replace the existing binary.

Next steps

• Obtain an API key to authenticate your requests.
• Explore the CLI parameters reference for command usage.