§ 01.01Getting Started

Installation

Quicx ships as a single static binary. One curl command detects your OS and architecture, verifies the checksum, and drops the daemon into your PATH.

The installer is a small POSIX sh script — it works on Linux (x86_64 / arm64) and macOS (Intel / Apple Silicon) without any additional tooling. No runtime dependencies, no package manager, no JDK. The Java client is distributed separately through Maven Central (see Quick Start).

install with curl

curl -fsSL https://quicx.dev/install.sh | sh

Prefer to inspect the script first? Download it, read it, then run it — everything the installer does is visible plaintext:

inspect first, install later

curl -fsSL https://quicx.dev/install.sh -o install-quicx.sh
less install-quicx.sh
sh install-quicx.sh

What the installer does

1 · detect: Reads uname -s and uname -m to pick the right platform string — linux-x86_64, linux-aarch64, darwin-x86_64 or darwin-arm64.
2 · resolve version: Defaults to latest, which resolves to the version pinned in the script itself (currently v1.0.3). Set QUICX_VERSION to pin a specific release — 1.0.3 and v1.0.3 are both accepted.
3 · fetch: Downloads the quicx-<platform> binary for that version straight from Quicx-Engine/Quicx-Releases on GitHub, over HTTPS, via curl (falling back to wget).
4 · install: Marks the binary executable and moves it into /usr/local/bin, retrying with sudoif that directory isn’t writable.
5 · verify: Checks that quicx resolves on PATH. If it doesn’t, prints the exact export PATH=… line to add instead of failing silently.

pin a specific version

QUICX_VERSION=1.0.3 curl -fsSL https://quicx.dev/install.sh | sh

Verify it worked

~ $

user@host ~ % quicx version
quicx v1.0.3

TIPOffline / airgapped installs

Download the release binary directly from github.com/Quicx-Engine/Quicx-Releases, copy it into your image, and drop a quicx.conf alongside it (or rely on the built-in default — see Configuration). No network access is required at runtime — Quicx never calls home.