Installation Script

ioBuster Pro provides an installer script that sets up both the iobc CLI and the Coordinator service on your machine. The script can be run interactively or fully automated with command-line flags.

Quick Install

Download and run the installer in one command:

curl -fsSL https://storage.googleapis.com/io-buster-pro/releases/install.sh | bash

This will:

1. Discover the latest available version from the release server
2. Prompt you to choose how to deploy the Coordinator (local Docker, remote host, or skip)
3. Download and install the iobc CLI binary
4. Write a config file pointing the CLI at the Coordinator

tip

If you prefer to inspect the script before running it, download it first:

curl -fsSL -o iobc-installer.sh https://storage.googleapis.com/io-buster-pro/releases/install.sh
less iobc-installer.sh   # review
bash iobc-installer.sh

Prerequisites

Requirement	Needed For
curl	Downloading the installer, CLI binary, and Coordinator image
docker	Running the Coordinator locally (not needed if using a remote or existing Coordinator)
ssh / sshpass	Deploying the Coordinator to a remote host (not needed for local or skip modes)

Install Docker

Docker is required only if you plan to run the Coordinator on the same machine where you are running the installer.

• Linux — follow the Docker Engine install guide for your distribution.
• macOS — install Docker Desktop for Mac.

Non-Interactive Usage

Pass flags to skip all prompts. This is useful for automation, CI pipelines, or scripted provisioning.

Install everything locally

bash iobc-installer.sh --local

Deploys the Coordinator in Docker on this machine and installs the CLI.

Deploy Coordinator to a remote host

bash iobc-installer.sh --remote 192.168.1.100 --user admin --password secret

SSHs into the remote host, downloads and runs the Coordinator in Docker there, then installs the CLI locally.

Use an existing Coordinator

bash iobc-installer.sh --skip --server 192.168.1.100:9100

Skips Coordinator deployment and installs only the CLI, pointing it at the given Coordinator address.

Install only the CLI

bash iobc-installer.sh --cli-only

Install only the Coordinator

bash iobc-installer.sh --coordinator-only --local

Pin a specific version

bash iobc-installer.sh --local --version 0.2.0

All Options

Flag	Description
--local	Deploy Coordinator locally via Docker
--remote <host>	Deploy Coordinator on a remote host via SSH
--user <user>	SSH username for remote deployment
--password <pass>	SSH password for remote deployment (omit for key-based auth)
--skip	Skip Coordinator deployment
--server <host:port>	Address of an existing Coordinator (used with --skip)
--cli-only	Install CLI only, skip Coordinator
--coordinator-only	Install Coordinator only, skip CLI
--version <ver>	Install a specific version instead of latest
-h, --help	Show help

Environment Variables

Variable	Default	Description
IOBC_GCS_BUCKET	gs://io-buster-pro/releases	GCS bucket path
IOBC_GCS_HTTP_BUCKET	https://storage.googleapis.com/io-buster-pro/releases	HTTP URL for downloads
IOBC_COORDINATOR_PORT	9100	Coordinator listen port

Self-Contained Installer

For air-gapped environments or offline installations, a self-contained installer is available. This is a single .sh file with the CLI binary embedded inside — no internet connection is required to install the CLI.

bash iobc-installer-0.2.0.sh --local

The self-contained installer works exactly like the standard installer. The only difference is that the CLI binary is extracted from the script itself instead of being downloaded from the release server. The Coordinator image is still downloaded from the release server unless you use --cli-only.

note

Contact your QA Maestro representative to obtain the self-contained installer for your target version.

Upgrade

Running the installer again on a machine with an existing installation will perform an upgrade:

• The Coordinator container is stopped, removed, and replaced with the new version. The iobc-data Docker volume is preserved, so all configuration and data carry over.
• The CLI binary is replaced in place.
• The config file is preserved; only the Coordinator address is updated if it changed.

The installer prints an upgrade summary showing the previous and new versions.

What Gets Installed

Component	Location	Description
iobc CLI	/usr/local/bin/iobc (root) or ~/.local/bin/iobc (user)	Command-line tool for managing hosts, ports, and jobs
Coordinator	Docker container iobc-coordinator on port 9100	Backend service that coordinates test hosts
Config	~/.iobc/config.yaml	CLI configuration pointing to the Coordinator
Docker volume	iobc-data	Persistent storage for Coordinator data
Docker network	iobc-net	Bridge network for Coordinator container

Verify Installation

After the installer completes, verify everything is working:

iobc host list

If the Coordinator is running and reachable, this will return an empty host list (or your existing hosts if upgrading).