Installation

Prerequisites

• Node.js 22+
• pnpm (recommended)
• Docker — for local infrastructure (TimescaleDB, Redis, Hatchet)
• PostHog account with API key
• Resend account with API key

Setup

1. Clone and install

git clone https://github.com/withseismic/hogsend.git
cd hogsend
pnpm install

2. Start infrastructure

docker compose up -d

This starts:

• TimescaleDB (Postgres 18) on port 5434
• Redis 8 on port 6380
• Hatchet-Lite — dashboard at localhost:8888, gRPC at localhost:7077

3. Configure environment

cp apps/api/.env.example apps/api/.env

Required environment variables:

4. Run migrations

cd packages/db && pnpm db:migrate

5. Start development

# Terminal 1: API server
pnpm dev

# Terminal 2: Hatchet worker
cd apps/api && hatchet worker dev

The API runs on http://localhost:3002. The Hatchet dashboard is at http://localhost:8888.