eyeballdocs
Self-hosting

Local self-hosting quickstart

Build the workspace and run the executor, MCP gateway, dashboard, and optional provider mocks.

Build all main-workspace packages:

Bash
pnpm install
pnpm build

Start the executor with one local project key:

Bash
EYEBALL_API_KEYS="eyeball_local_key:proj_local" \
  PORT=3000 \
  pnpm --filter @eyeball/executor start

By default the stock server starts in mock mode with no real provider credentials. For deterministic provider work, point adapters at Mockhouse. To connect real accounts, set EYEBALL_CREDENTIALS=env or EYEBALL_CREDENTIALS=local-vault on this same server — no custom code — as described in Connect real providers.

In separate processes:

Bash
EYEBALL_API_KEYS="eyeball_local_key:proj_local:demo_user" \
EYEBALL_EXECUTOR_API_KEY="eyeball_local_key" \
EYEBALL_EXECUTOR_URL="http://127.0.0.1:3000" \
EYEBALL_USER_ID="demo_user" \
PORT=3001 \
pnpm --filter @eyeball/mcp-gateway start

EYEBALL_API_KEY="eyeball_local_key" \
EYEBALL_EXECUTOR_URL="http://127.0.0.1:3000" \
pnpm --filter @eyeball/dashboard start

Health-check the executor at GET /health, then use the SDK quickstart or connect an MCP client to http://127.0.0.1:3001/mcp.