Documentation Index
Fetch the complete documentation index at: https://docs.yourhq.ai/llms.txt
Use this file to discover all available pages before exploring further.
Self-hosted: zero telemetry
The self-hosted HQ stack does not phone home. There is no analytics endpoint, no crash reporter, no usage beacon, and no license check server. Your install never contacts a YourHQ-operated server. The only network calls your HQ instance makes are:| Destination | When | Why |
|---|---|---|
| Your Supabase project | Always | Required — all data lives here |
| Tailscale control plane | If you enable Tailscale | Managed by Tailscale, not HQ |
| OpenClaw services | Agent model auth, plugin updates | Managed by OpenClaw |
GHCR (ghcr.io) | docker compose pull | Image downloads |
get.docker.com | Installer only | Docker install script (upstream) |
tailscale.com/install.sh | Installer only | Tailscale install script (upstream) |
| npm, PyPI, apt | Build/dev only | Dependency resolution |
Hosted: what we collect
If you use the hosted offering at app.yourhq.ai, the control plane stores operational data needed to provision and manage your workspace. See the hosted trust model for full details. Stored in the control-plane database:- Your email address and display name
- Stripe customer and subscription IDs
- Your workspace’s Supabase project reference, URL, and anon key (not secret — same data your browser uses)
- Encrypted service-role key and database password (ChaCha20-Poly1305)
- E2B sandbox ID, status, and access URLs
- Provisioning progress and setup metadata
- Your Supabase data (contacts, tasks, knowledge, agent data)
- Agent session content or outputs
- noVNC/remote desktop session data
- LLM prompts or responses
- Sentry — error tracking for the UI (client/server/edge), worker, and Python gateway daemons. Captures stack traces and error metadata. Never active in self-hosted installs.
- PostHog — product analytics for the hosted dashboard. Captures page views and UI interactions. Never active in self-hosted installs.
RUNTIME_MODE=hosted — self-hosted installs have no Sentry DSN and no PostHog key, so these SDKs are inert.
Data residency
Self-hosted: your data lives wherever you put it. Your Supabase project, your gateway host, your choice of region. Hosted: each workspace gets a dedicated Supabase project (currently US regions via Supabase Cloud). Gateway sandboxes run on E2B infrastructure. We do not currently offer region selection for hosted workspaces — if this matters to you, self-host.Data retention and deletion
Self-hosted: you control retention. HQ doesn’t auto-delete anything. The database grows with your usage. Back up regularly (see Operations). Hosted: when you cancel a workspace, the sandbox is paused immediately (no compute charges). After 30 days:- The E2B sandbox is permanently destroyed
- The Supabase project is permanently deleted
- All encrypted credentials are cleared from the control-plane database
Cookies and local storage
The HQ dashboard uses:| Item | Purpose | Scope |
|---|---|---|
Supabase auth cookies (sb-*) | Session authentication | Your Supabase project domain |
workspace (localStorage) | Active workspace ID | Your HQ domain |
| Theme preferences (localStorage) | UI appearance settings | Your HQ domain |

