> ## 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.

# Requirements

> Infrastructure and accounts needed to run Your HQ.

HQ is self-hosted software. The minimum setup is one machine that can run Docker and one Supabase project.

<Tip>
  Don't want to manage infrastructure? [HQ hosted](/hosted/getting-started) handles all of this for you — sign up and start creating agents in 2 minutes.
</Tip>

## Required pieces

<CardGroup cols={2}>
  <Card title="Docker host" icon="server">
    A laptop, Mac mini, Raspberry Pi, VPS, home server, or cloud VM that can run Docker Compose.
  </Card>

  <Card title="Supabase project" icon="database">
    Stores your workspace data, auth users, realtime events, command queues, and agent state metadata.
  </Card>

  <Card title="Model provider" icon="plug">
    Any provider — OpenAI, Anthropic, Gemini, Ollama, or 25+ others. HQ is model-agnostic.
  </Card>

  <Card title="Gateway token" icon="key">
    A `GATEWAY_AUTH_TOKEN` shared by the UI and gateway files API. The installer can generate this for you.
  </Card>
</CardGroup>

## Recommended

<CardGroup cols={2}>
  <Card title="Tailscale" icon="network-wired">
    The easiest safe way to reach Your HQ from another device without opening public ports.
  </Card>

  <Card title="Dedicated Supabase project" icon="shield-halved">
    Keeps HQ data and permissions separate from other apps.
  </Card>

  <Card title="Backups" icon="box-archive">
    Back up Supabase, `.env`, and the `gateway-state` Docker volume before running real workflows.
  </Card>

  <Card title="Pinned images" icon="tag">
    Pin image versions once you depend on HQ for daily work.
  </Card>
</CardGroup>

## Host sizing

Active browser agents use memory and CPU, so plan capacity around active agents, not just total agents.

| Host                    | RAM   | Comfortable for   |
| ----------------------- | ----- | ----------------- |
| Raspberry Pi 5          | 8 GB  | 1–2 agents        |
| t3.small / Hetzner CX22 | 2 GB  | 1 idle agent      |
| t3.medium / Mac mini    | 4 GB  | 2–3 active agents |
| t3.large or larger      | 8+ GB | 5+ active agents  |

## Security assumptions

HQ is self-hosted admin software with tenant-scoped RLS. Self-hosted installs use a single default tenant, so all authenticated users share the workspace. Anyone with access to your Supabase auth user, service role key, gateway state volume, or Docker host should be treated as trusted.

Read [Security policy](/security/security-policy) before exposing HQ beyond localhost.