← Blog

Introducing ContextBay

announcementarchitecture

If you run a homelab, you know the stack: Portainer for containers, Grafana for dashboards, n8n for automation, Wazuh for security, Obsidian for notes. Each one is great individually, but together they're a sprawl of logins, configs, and maintenance.

The Vision

ContextBay is a single self-hosted binary (Go backend + embedded Next.js frontend) that unifies all of them. One Docker image for the master node, one for workers. Deploy, monitor, automate, document, and secure your homelab from one UI.

What's Built

  • Container Management — Full Docker lifecycle: create, start, stop, restart, remove, logs, shell access, image/volume/network management
  • Monitoring Dashboards — Configurable panels with time-series charts, gauges, stats. Real-time WebSocket updates
  • Alert Rules Engine — Threshold-based alerts with Prometheus import support
  • Workflow Automation — n8n deployed as a sub-container, auto-bootstrapped owner + API key, 36 seeded workflows, 500+ integrations
  • Knowledge Base / Brain — Markdown vault with bidirectional links, Cytoscape.js graph, and RAG search powered by local Ollama embeddings
  • Tiered AI — Claude Code for reasoning and tool-use, cb-ollama for cheap classification and RAG
  • Security Monitor — Wazuh (cb-wazuh) for SIEM + FIM + vuln scanning
  • Discord Bot — slash commands for container management, monitoring, and alerts
  • Project Planner — Kanban, Gantt, sprints, velocity, and burndown — issues live in CB, not GitHub

Tech Stack

Go 1.26+ backend, Next.js 15 + React 19 frontend, shadcn/ui components, dark theme, SQLite (WAL) or PostgreSQL, Headscale-encrypted gRPC for master-worker communication, Portainer as the Docker control plane, and a whole lot of love for homelabs.

Open Source

ContextBay is MIT licensed. The code is on GitHub. Star it, fork it, contribute.