QuicxDocs

Installation

Quicx ships as a single static binary. One curl command detects your OS and architecture, downloads the matching release from GitHub, and drops the daemon into your PATH.

The installer is a small POSIX sh script that 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; its coordinates are in the Java client’s Maven and Gradle setup.

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 plain text:

inspect first, install later
curl -fsSL https://quicx.dev/install.sh -o install-quicx.shless install-quicx.shsh 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 v2.1.0). Set QUICX_VERSION to pin a specific release; 2.1.0 and v2.1.0 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), then checks it against that version’s SHA256SUMS and stops on a mismatch.
4 · install
Marks the binary executable and moves it into /usr/local/bin, retrying with sudo if that directory isn’t writable. Set QUICX_INSTALL_DIR to install somewhere else, for example ~/.local/bin without sudo.
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 version or choose where it goes
curl -fsSL https://quicx.dev/install.sh | QUICX_VERSION=2.1.0 sh # into ~/.local/bin, without sudocurl -fsSL https://quicx.dev/install.sh | QUICX_INSTALL_DIR=~/.local/bin sh

Verify it worked#

~ $
user@host ~ % quicx versionquicx v2.1.0 

Next, run a first task queue in Java: a daemon with a memory budget, a worker and a producer, in about a minute.