Install the OwnStack CLI
The OwnStack CLI is a single compiled binary (no runtime, interpreter, or dependencies to install). macOS and Linux are first-class on both Intel and Apple Silicon / ARM; Windows users should run it under WSL.
Install
The recommended install is a one-liner. It detects your OS and architecture, downloads the matching binary plus its runtime assets to ~/.ownstack/cli, and symlinks ownstack onto your PATH:
$ curl -fsSL https://ownstack.org/install.sh | bash
Or with Homebrew (macOS / Linux):
$ brew install ownstack-org/tap/ownstack
Verify the install:
$ ownstack --version
ownstack 2026.11.19.3
Re-run the install one-liner to upgrade, or brew upgrade ownstack if you installed via Homebrew.
Pick a control plane
The CLI talks to a control plane. By default that's the hosted one at https://api.ownstack.org. If you're self-hosting, add a profile that points at your own URL, using an API token from that control plane's Settings page.
$ ownstack login # hosted
$ ownstack profile add selfhosted --api-url https://api.example.com --token YOUR_API_TOKEN # self-hosted
$ OWNSTACK_PROFILE=selfhosted ownstack apps # use it per command
Login opens a browser, completes the OAuth flow, and writes the resulting token to ~/.ownstack/profiles/<name>.
Profiles
Each control-plane endpoint is a profile. Run multiple at once if you have a hosted account and a self-hosted instance, or one profile per organization.
$ ownstack profile list
personal
* work (active)
selfhosted
$ ownstack profile show
API URL: https://api.ownstack.org
Active profile: work
Token: 1a2b3c4d…
$ ownstack profile use work
The CLI does not warn you when deploy, db, or ssh would run against the wrong profile. Run ownstack profile show first if you've been switching contexts.
Where things live
| Path | What's there |
|---|---|
~/bin/ownstack | The CLI executable. |
~/.ownstack/cli/ | Helper libraries (lib/db.sh, lib/control_plane.sh, etc.). |
~/.ownstack/profiles/<name> | One file per profile, holding API URL and token. |
~/.ownstack/config | Global config (active profile, defaults). |
./.ownstack-config | Per-repo: links the local checkout to a specific app on the active control plane. |
Next
You're ready to deploy your first app.