§ 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 artifact — linux-x86_64, linux-arm64, darwin-x86_64 or darwin-arm64.
2 · fetch: Downloads the signed release tarball from releases.quicx.dev over HTTPS.
3 · verify: Checks the SHA‑256 against the signed SHA256SUMS file. Exits non-zero if the hash does not match.
4 · install: Places the quicx binary in /usr/local/bin (or ~/.local/bin if the user does not have root). Writes a default quicx.conf to ~/.config/quicx/.
5 · verify: Runs quicx version and prints the resolved install path so you know the PATH lookup works.

Verify it worked

~ $

user@host ~ % quicx version
quicx v1.0.2

TIPOffline / airgapped installs

Download the release archive directly from github.com/anastassow/Quicx/tree/main/releases, copy the binary into your image, and drop the quicx.conf alongside it. No network access is required at runtime — Quicx never calls home.