Troubleshooting FAQ
Short answers. Each one links to a deeper guide when useful.
Install says unidentified developer
Expected on some betas. Right-click → Open, or use the curl installer. See Install.
Port already in use
Reclaim from the project or ⌘K. Details in Ports & crashes.
Process keeps crashing
Read the unified log and last-exit reason. Fix env / DB first; then restart. MCP can pull logs into your editor — Connect MCP.
Docker / DB won’t start
Start Docker Desktop, run Setup diagnose, then retry managed Postgres/Redis. Guide: Databases.
MCP tools missing in Cursor
Hub running? Token current? Re-link from Connections. See MCP.
Live Link won’t start
Sign in to cloud, ensure the project is running with a local URL, then Share → Live Link. Live Link guide.
Does Rig upload my source?
No. Sync and Continuity never upload repo contents. Live Link only proxies a running HTTP process. Read Cloud & Continuity.
Lost Continuity recovery key
Those snapshots cannot be decrypted — by design. You can keep using Rig locally and start fresh Continuity with a new key. We cannot reset the old key.
Do I need a cloud account?
Not for local run/logs/ports/MCP/LAN. Yes for Live Link, Continuity, multi-Mac sync, and fleet.
Still stuck
Follow How to get help and open Support with version + logs.