ownstack profile

A profile is a saved control-plane endpoint plus an auth token. Each profile lives at ~/.ownstack/profiles/<name>.

List & show

$ ownstack profile list
  personal
* work (active)
  selfhosted

$ ownstack profile show
API URL: https://api.ownstack.org
Active profile: work
Token: 1a2b3c4d…

Switch

$ ownstack profile use <name>
Always check before state-changing commands

The CLI does not warn when deploy, db, or ssh would run against the wrong profile. Run ownstack profile show first if you've been switching contexts.

Adding profiles

$ ownstack login                                # creates/refreshes the active profile
$ ownstack profile add selfhosted --api-url https://api.example.com --token <token>  # new profile for a different control plane, active profile unchanged
$ ownstack login --token <token>                 # skip browser, paste a token directly

--token is useful for CI environments and headless machines.