KieloDocs

Install Kielo Desktop Node

One-line terminal install or manual DMG download for macOS Apple Silicon.

Recommended: one-line install

On macOS Apple Silicon, run the installer script. It downloads the latest DMG, mounts it, and copies Kielo Desktop Node.app to /Applications.

curl -fsSL https://kielo.in/install.sh | bash

What the script does

  1. Prints Kielo branding in the terminal
  2. Verifies macOS on arm64
  3. Downloads https://kielo.in/download/kielo-desktop-mac.dmg
  4. Installs to /Applications/Kielo Desktop Node.app
  5. Prints next steps (sign in → onboard → go live)

Environment options

# Custom install location (testing or managed deployments)
KIELO_INSTALL_DIR="$HOME/Applications" curl -fsSL https://kielo.in/install.sh | bash

# Custom download host (staging / local dev)
KIELO_INSTALL_BASE=http://localhost:3000 bash -c "$(curl -fsSL http://localhost:3000/install.sh)"

Manual download

Prefer a GUI installer? Download the DMG from the provider download page and drag the app to Applications.

  • Version: v0.1.0
  • Architecture: aarch64 (Apple Silicon)
  • Direct path when self-hosting the web app: /download/kielo-desktop-mac.dmg

After install

  1. Open Kielo Desktop Node from Applications
  2. Sign in with your Kielo provider account
  3. Complete the onboarding flow

Troubleshooting

“Unsupported OS” or “Intel Mac detected”

v0.1.0 targets Apple Silicon only. Use the manual DMG path on the download page when an Intel build ships, or wait for the headless kielo-node CLI.

curl returns 404

Ensure install.sh is served at https://kielo.in/install.sh and the DMG exists at https://kielo.in/download/kielo-desktop-mac.dmg. In local dev, use the port printed by bun dev (often not 3000).

Re-run safely

The script is idempotent — re-running replaces the existing app bundle in the install directory.

Next