// RUNNING KAPTAIN

Run Kaptain on macOS

macOS blocks unsigned downloads by default. Kaptain is not yet signed with an Apple Developer certificate, so this is the one extra step you need.

You will see: “Apple could not verify ‘kaptain’ is free of malware.” That is Gatekeeper reacting to the missing signature, not to anything found in the file.

Allow it to run

  1. Open Terminal and go to your downloads: cd ~/Downloads
  2. Make it executable: chmod +x kaptain-macos-arm64 (or kaptain-macos-x64 on an Intel Mac).
  3. Clear the quarantine flag macOS attached to the download:
    xattr -d com.apple.quarantine kaptain-macos-arm64
  4. Move it somewhere on your PATH: sudo mv kaptain-macos-arm64 /usr/local/bin/kaptain
  5. Start it: kaptain start

If you would rather not use Terminal

Double-click the file. When macOS refuses, open System Settings → Privacy & Security, scroll to Security, and choose Open Anyway next to the message about Kaptain. Recent macOS versions only show that button for a few minutes after the blocked attempt, so if it is not there, try opening the file again first.

Simplest option: the terminal installer does all of the above for you — curl -sL https://chynj.ca/install.sh | sh, then kaptain start.

What happens on first run

  1. Kaptain opens at localhost:8810 in your browser.
  2. The setup wizard appears. Create your CHYNJ account or sign in — your free 3-day trial starts here, and no card is needed.
  3. Verify your email address. We send the link as soon as you sign up; the trial needs a verified address.
  4. Pick a model runtime. Kaptain detects Ollama, llama.cpp, and the Claude and Codex CLIs, and tells you how to install whichever you are missing.
  5. Choose your project folder and network settings, and you are done.

The trial is tied to this device, so reinstalling does not start a new one. Subscribing later keeps everything you set up here.

Stuck? support@chynj.ca.

The full picture: the Kaptain Setup Guide covers which build to pick for your machine, what each model runtime needs, and the whole first-run wizard.

// OTHER PLATFORMS