Skip to content

Install on Linux

The Connector supports any modern 64-bit Linux distribution (Ubuntu, Debian, Fedora, RHEL, Rocky, Arch, Alpine, …) on x86_64 or arm64.

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.

Option 2: Homebrew on Linux

If you use Homebrew on Linux:

brew install kualico/tap/kuali

Option 3: npx

With Node.js (18+):

npx @kualico/kuali-connector@latest --help

Option 4: 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

kuali version

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

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>.