Install & login
The installer finished butgrid is not found
- Open a new terminal (the installer appends to your shell profile), or run
export PATH="$HOME/.grid/bin:$PATH"in the current one.
login opens the browser but the CLI never completes
- The login flow runs a one-shot local callback server — make sure the
browser and the CLI are on the same machine (over SSH, forward the port the
CLI prints, or use a machine with a local browser).
switchlets you pick a different cluster if your organization has more than one.
- Your organization’s GRID admin portal shows the install one-liner
pre-filled with
--cluster-urlon its Welcome screen. If you installed without it, re-run the installer with that flag from the portal.
Robots & sessions
robot list shows nothing / my robot is offline
- The robot’s GRID edge runtime must be running and able to reach the
network. Re-run
robot addto re-verify the setup — it detects an existing installation and offers to reuse, repair, or overwrite it.
- The runtime key is generated in the admin portal and saved for the cluster
you paste it into. GRID asks for one at startup when the cluster it’s
pointed at hasn’t got one;
robot addasks too. Paste it there and deploy again. The footer names the cluster whose key is in use.
- Yes — sessions are independent.
session listshows what’s running;session stopends a session you’re done with.
When something breaks
Get help fastdiagnostics— bundles redacted logs + config into~/grid-diagnostics-*.tar.gz; attach it to your support ticket.error— recalls the last failure in full, including the correlation ID support will ask for.debug on— verbose logging for the current session; the full log lives at~/.grid/logs/cli.log.