Kubernetes (Helm)

nitrohook includes a Helm chart in charts/ that deploys the full stack: API server, fan-out workers, Postgres, and Redis.

Quick install

helm install nitrohook ./charts \
  --set api.ingress.host=nitrohook.example.com

What gets deployed

Component	Kind	Replicas
API server	Deployment	1 (configurable)
Fan-out worker	Deployment	3 (configurable)
PostgreSQL	StatefulSet	1
Redis	StatefulSet	1
Ingress	Ingress	1 (optional)

The API deployment runs database migrations as an init container before starting.

Values reference

Images

image:
  api:
    repository: ghcr.io/zachbroad/nitrohook-api
    tag: main
  worker:
    repository: ghcr.io/zachbroad/nitrohook-worker
    tag: main

API

api:
  replicaCount: 1
  migration:
    enabled: true
  ingress:
    enabled: true
    className: nginx
    host: nitrohook.test
    tls: []
    #  - secretName: nitrohook-tls
    #    hosts:
    #      - nitrohook.test

Worker

worker:
  replicaCount: 3
  resources:
    requests:
      cpu: 100m
      memory: 128Mi
    limits:
      cpu: 500m
      memory: 256Mi

Application config

These go into a ConfigMap and map to the same environment variables as Docker Compose:

appConfig:
  port: "8080"
  workerConcurrency: "4"
  maxRetries: "5"
  retryBaseDelay: "5s"
  deliveryTimeout: "10s"
  pollInterval: "30s"

Postgres

postgres:
  user: relay
  password: relay
  database: nitrohook
  storage: 5Gi
  storageClass: ""

Redis

redis:
  storage: 1Gi
  storageClass: ""

Secrets

By default the chart creates a Secret with the database and Redis connection strings. To use an existing secret:

secret:
  create: false
  existingSecret: my-nitrohook-secret

The secret must contain DATABASE_URL and REDIS_URL keys.

Accessing the UI

With ingress enabled, DNS resolution depends on your setup:

• minikube — enable the ingress-dns addon to automatically resolve *.test domains to your minikube IP:

  minikube addons enable ingress
  minikube addons enable ingress-dns

• Cloud / bare metal — point your DNS record at the ingress controller’s external IP.

Without ingress:

kubectl port-forward svc/nitrohook-api 8080:80
open http://localhost:8080