Kuali Connector: Installation: Linux

OPTION 1

Install script

curl -fsSL https://connector.kuali.co/install.sh | sh

The script auto-detects your architecture and installs to /usr/local/bin/kuali. If /usr/local/bin isn't writable by your user, it uses sudo.

Install a specific version (prereleases or older builds)

Set KUALI_VERSION to any published release tag — with or without the v prefix:

curl -fsSL https://connector.kuali.co/install.sh | KUALI_VERSION=1.0.0-rc14 sh

Without KUALI_VERSION, the script installs the latest stable release.

OPTION 2

Homebrew on Linux

If you use Homebrew on Linux:

brew update && brew install kualico/tap/kuali

OPTION 3

Direct download — no sudo

If you'd rather install without root access:

# Detect your architecture

ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')

# Download the latest binary

curl -fsSL \
-o ~/.local/bin/kuali \
"https://github.com/kualico/kuali-connector/releases/latest/download/kuali-linux-${ARCH}"

chmod +x ~/.local/bin/kuali

Make sure ~/.local/bin is on your PATH. Add this to ~/.bashrc or ~/.zshrc if it isn't:

export PATH="$HOME/.local/bin:$PATH"

Then reload your shell (source ~/.bashrc) or open a new terminal.

VERIFY

Check it worked

kuali version

KEYCHAIN

Keychain on Linux

The Connector uses the libsecret keychain (GNOME Keyring, KeePassXC, KDE Wallet) via D-Bus. On desktop Linux this Just Works. On headless servers the keychain is often unavailable — the Connector falls back to ~/.kuali/credentials (mode 0600), or you can supply credentials via the KUALI_API_KEY / KUALI_<PROFILE>_API_KEY environment variables.

UNINSTALL

Clean removal

sudo rm /usr/local/bin/kuali

rm -rf ~/.kuali

rm ~/.local/bin/kuali

rm -rf ~/.kuali

brew uninstall kuali

brew untap kualico/tap

If you stored API keys in the keychain, you can remove them via your desktop's secret-management tool (Seahorse, KDE Wallet Manager) or with secret-tool clear service kuali-cli account <profile>.

Last updated: September 21, 2026

ON THIS PAGE

Option 1: Install script Option 2: Homebrew on Linux Option 3: Direct download (no sudo)Verify Keychain on Linux Uninstall

<- Installation overview

Where to next