GridWork HQ
Installation

Installation

Choose your deployment method for GridWork HQ.

Installation

GridWork HQ supports four deployment methods. Pick the one that matches your infrastructure.

MethodDashboardPipeline ServerBest For
Locallocalhost:3000localhost:8750Development, solo operators
VPSVPS (Nginx)VPS (systemd)Always-on, maximum control
Vercel + TailscaleVercel edgeYour machine (Tailscale)Zero-ops UI, local pipeline server
DockerContainerContainerContainerized environments

Architecture Reminder

GridWork HQ has two packages that must both be running:

  1. gridwork-hq — Next.js dashboard (port 3000). Handles the UI, authentication, API routes, and SQLite database.
  2. pipeline-server — Node.js HTTP server (port 8750). Spawns Claude Code processes, manages the job queue, runs cron jobs, and streams results via SSE.

The dashboard communicates with the pipeline server over HTTP using a shared bearer token. They can run on the same machine or on different machines.

All Methods Start the Same Way

Regardless of deployment target, you always:

  1. Extract the ZIP or clone the repos
  2. Run npm install in both packages
  3. Run node setup-wizard.mjs in gridwork-hq/
  4. Set up the knowledge vault from the template

The deployment-specific steps come after the setup wizard configures your environment.

First Pipeline Run

Run your first AI pipeline and see GridWork HQ in action.

Local (Mac/Linux)

Install GridWork HQ on your local Mac or Linux machine for development and solo agency operations.

On this page

InstallationArchitecture ReminderAll Methods Start the Same Way