Skip to the page
← All docs

Install and pair

The agent, strata, runs on a machine inside your network that can reach what you connect: a laptop, a jump host or a server. It dials out to the service; nothing is opened inbound.

Getting it. On a Mac or Linux, in a terminal:

curl -fsSL https://orbstrata.com/install.sh | sh

It downloads the agent built for this machine, checks the file's sha256 against the release, and puts strata in ~/.local/bin. For another folder: curl -fsSL https://orbstrata.com/install.sh | sh -s -- --dir /usr/local/bin. It changes nothing else: no shell profile, no token. If that folder is not on your PATH it says so. On Windows, in PowerShell:

irm https://orbstrata.com/install.ps1 | iex

It puts strata.exe in your user's Programs folder; add that folder to your PATH. On a Mac, a binary fetched this way runs as it is. One downloaded through a browser is stopped by Gatekeeper, because the agent is not notarised by Apple yet: use the line above. Every release is signed; strata update --check checks the signature and says whether a newer one is out.

Once it is on the machine:

  • strata doctor checks the machine first: a private home for the agent, a keyring that works, the service answering, a clock in step.
  • strata login pairs it with your workspace. It prints a code and opens the console's pairing page; check that the code matches and choose Pair this agent.
  • strata connect add postgres (or mysql, mssql, oracle, or sqlite --file <path>) adds a database. It refuses a role that can write, and keeps the URL in this machine's keyring.
  • strata mcp --install claude-desktop gives the agent to your AI client (Your AI client says more).

strata status says what the agent is paired with and how many connections it has, at any time.