Installing `qumod`

qumod is the official command-line interface and automation runtime for Qumo Deploy. It is compiled as a self-contained, native executable with no external dependencies (neither Node.js nor Deno is required on the host system).

Direct Binary Download (Recommended)

Pre-built standalone binaries are published with each release from the official repository:

Platform	Architecture	Binary Asset
macOS	Apple Silicon (M1/M2/M3)	`qumod-darwin-arm64`
macOS	Intel (x86_64)	`qumod-darwin-amd64`
Linux	x86_64	`qumod-linux-amd64`
Linux	ARM64 (aarch64)	`qumod-linux-arm64`
Windows	x86_64	`qumod-windows-amd64.exe`

macOS & Linux Quick Install

Run the following command to detect your operating system architecture, download the latest binary, verify permissions, and install to /usr/local/bin:

curl -fsSL https://github.com/foalk-inc/qumo-deploy/releases/latest/download/qumod-darwin-arm64 -o /usr/local/bin/qumod
chmod +x /usr/local/bin/qumod

curl -fsSL https://github.com/foalk-inc/qumo-deploy/releases/latest/download/qumod-darwin-amd64 -o /usr/local/bin/qumod
chmod +x /usr/local/bin/qumod

curl -fsSL https://github.com/foalk-inc/qumo-deploy/releases/latest/download/qumod-linux-amd64 -o /usr/local/bin/qumod
chmod +x /usr/local/bin/qumod

curl -fsSL https://github.com/foalk-inc/qumo-deploy/releases/latest/download/qumod-linux-arm64 -o /usr/local/bin/qumod
chmod +x /usr/local/bin/qumod

If /usr/local/bin is not in your $PATH or requires root privileges, you can install to ~/.local/bin/qumod or run with sudo.

Windows Installation

On Windows, download the executable using PowerShell and add it to your user path:

PowerShell

New-Item -ItemType Directory -Force -Path "$HOME\bin"
Invoke-WebRequest -Uri "https://github.com/foalk-inc/qumo-deploy/releases/latest/download/qumod-windows-amd64.exe" -OutFile "$HOME\bin\qumod.exe"
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$HOME\bin", "User")

Restart your terminal session or reload $env:Path to make qumod available globally.

Verifying Installation

Verify that the CLI is installed properly and accessible:

qumod version

Expected output:

qumod v0.1.0 (x86_64-apple-darwin)
API target: https://api.qumo.dev

You can also test JSON output format:

qumod version --json

{
  "version": "0.1.0",
  "os": "darwin",
  "arch": "aarch64",
  "apiUrl": "https://api.qumo.dev"
}

Next Steps

Now that you have qumod installed, authenticate your account:

Authentication Guide

Learn how to authenticate interactively via browser Device Flow or headless API tokens.

​Installing qumod

​Direct Binary Download (Recommended)

​macOS & Linux Quick Install

​Windows Installation

​Verifying Installation

​Next Steps

Authentication Guide

Installing `qumod`

Direct Binary Download (Recommended)

macOS & Linux Quick Install

Windows Installation

Verifying Installation

Next Steps