xcluster
Homelab orchestration platform: manage clusters, SSH terminals, Docker and monitoring from a single dashboard. Kubernetes support in progress.
The problem
Running a homelab means SSH-ing into each machine, running commands, checking metrics, restarting services, over and over for every node. 5 machines means 5 terminals. 10 machines means chaos.
Enterprise tools like Rancher or Portainer are too heavy for a homelab. Ansible only handles provisioning and has no real-time dashboard.
The solution
xcluster is a control plane for your homelab: one dashboard to manage every machine, cluster, container and terminal. Wake a machine with one click, SSH straight from the browser, watch metrics in real time, without opening a single terminal.
Private project. Being extended for Kubernetes cluster management. Get in touch if you’re interested.
Key features
- Machine management: register machines, auto-discovery over SSH, multiple auth methods (password, PEM, SSH keys), encrypted credential storage (AES-256-GCM)
- Wake-on-LAN: send a magic packet to wake machines remotely, bulk wake for a whole cluster
- Cluster orchestration: group machines into clusters, assign master/worker roles, bulk operations with smart ordering (workers first, master last on reboot)
- Web SSH terminal: interactive shell straight from the browser over WebSocket, full PTY support, so vim, htop and tmux work as usual
- Docker management: containers, images, volumes, networks, object inspection, lifecycle operations, scheduled tasks
- Real-time monitoring: a background worker collects CPU, RAM, disk, temperature and uptime every 30 minutes, with live updates over Pusher WebSocket
- Auto SSH provisioning: generates SSH keys, exchanges them and sets up passwordless access
- Type-safe API client: TypeScript SDK auto-generated from the OpenAPI spec, kept in sync by CI/CD
Architecture & tech
Backend (Go): Gin framework · Domain-Driven Design · Dependency Injection container · GORM + PostgreSQL · Gorilla WebSocket (SSH proxy) · AES-256-GCM encryption · Zerolog structured logging · Swagger/OpenAPI 3.0 auto-generation · Cron scheduler · Multi-stage Alpine Docker build
Frontend (React): Vite 6 · React 19 · TypeScript · Tailwind CSS v4 · xterm.js interactive terminal emulator · Monaco Editor (YAML/JSON config editing) · Pusher real-time events · React Router · Lucide icons
Shared SDK (TypeScript): Auto-generated from the OpenAPI spec · openapi-fetch client · Type-safe API calls · Bun build tooling
CI/CD pipeline: Backend push → Generate Swagger → Push types to SDK lib → Trigger frontend rebuild → Docker image → Container registry. Fully automated, zero manual steps.
Roadmap: Kubernetes cluster provisioning, pod management, Helm chart deployment, log streaming, Grafana-level metrics dashboard.
Private project. Get in touch for more details.