llamacloudctl is the deployment manager for a customer-managed LlamaParse /
LlamaCloud Kubernetes installation, built on the llamaindex/llamacloud Helm
chart. Deploy LlamaParse in your own Kubernetes environment while retaining
control of infrastructure, networking, data, and security.
This repository is the public distribution channel — it hosts the installer and the prebuilt release binaries. (The tool's source is maintained privately.)
llamacloudctl ships as a single static binary — no runtime, no shared
libraries. Prebuilt binaries are published for:
| OS | Architectures |
|---|---|
| Linux | amd64, arm64 (static — runs on glibc and musl/Alpine) |
| macOS | amd64 (Intel), arm64 (Apple Silicon) |
| Windows | amd64, arm64 |
sh -c "$(curl -fsSL https://raw.githubusercontent.com/run-llama/llamacloudctl/main/install.sh)"The script detects your OS and CPU architecture, downloads the matching release
archive, verifies its SHA-256 checksum, and installs llamacloudctl to
/usr/local/bin (or ~/.local/bin when that isn't writable).
Override the defaults with environment variables:
| Variable | Default | Purpose |
|---|---|---|
LLAMACLOUDCTL_VERSION |
latest |
Release tag to install, e.g. v0.1.0 |
LLAMACLOUDCTL_INSTALL_DIR |
auto | Target directory for the binary |
LLAMACLOUDCTL_REPO |
run-llama/llamacloudctl |
Source repo (mirror override) |
Prefer to read before you pipe to a shell? Download
install.sh, inspect it, then run it.
Native packages are attached to every release:
# Debian / Ubuntu
curl -fsSLO https://github.com/run-llama/llamacloudctl/releases/latest/download/llamacloudctl_0.1.0_linux_amd64.deb
sudo dpkg -i llamacloudctl_0.1.0_linux_amd64.deb
# RHEL / Rocky / Alma / Fedora / SUSE
sudo rpm -i https://github.com/run-llama/llamacloudctl/releases/download/v0.1.0/llamacloudctl_0.1.0_linux_amd64.rpm
# Alpine
sudo apk add --allow-untrusted llamacloudctl_0.1.0_linux_amd64.apkDownload the _windows_amd64.zip (or _arm64) from the
Releases page, extract llamacloudctl.exe, and add its folder
to PATH.
llamacloudctl --help
llamacloudctl version
llamacloudctl preflight # validate the target cluster + configuration
llamacloudctl install # guided install of the llamaindex/llamacloud chart