kubiq

⚡ What's New

Autoscaling Management

Added support for fetching and reading raw YAML for horizontalpodautoscalers and verticalpodautoscalers.
Added UI actions to delete HPA and VPA resources.
Replaced native browser confirm dialogs with K8sConfirmModal for deletion actions.

Kubernetes API Client Fixes

Fixed 415 Unsupported Media Type errors during scaling and restarting by updating patch methods to match @kubernetes/client-node API requirements.
Fixed 409 Conflict errors during resource updates by stripping immutable metadata fields (resourceVersion, uid, creationTimestamp, generation) and status before applying patches.

UI / UX Fixes

Fixed layout issues with Quick Action buttons (Replicas, Rolling Restart, Delete) wrapping incorrectly on smaller mobile screens.

🤝 Contributors

Built with ❤️ by @priyanshumodi22.

If you like kubiq, please give us a star on GitHub! ⭐

v2.0.1

May 20, 2026

kubiq v2.0.1 - APM Export & Observability Polish

🚀 Overview Release v2.0.1 focuses on bringing enterprise-grade data portability to kubiq APM. We've introduced a highly requested feature: the ability to export your slow queries and trace data directly to beautifully formatted CSVs for external analysis, reporting, and long-term archiving.

✨ What's New

📥 Advanced APM Trace Exporting You can now download your trace data directly from the APM dashboard into clean, spreadsheet-ready CSV files.

Precision Time Filtering: Filter your exports precisely using an intuitive, custom-built 12-hour AM/PM time range selector.
Granular Criteria: Filter exports by specific Services, Minimum Duration thresholds (e.g., > 5s), Span Name search queries, or toggle "Errors Only" to instantly generate incident reports.
Comprehensive CSV Schema: The exported data automatically maps your OpenTelemetry attributes into organized columns including db.statement, http.url, messaging.destination, and exact IST timestamps.

🎨 Premium UI & UX Upgrades The APM dashboard has received another wave of visual polish.

Glassmorphic Export Modal: A breathtaking new modal component built with deep glassmorphism, dynamic gradients, and animated interactions.
Custom Dropdowns: Completely stripped out native browser <select> elements in the export flow, replacing them with sleek, theme-consistent custom dropdowns.
Robust Time Parsing: Re-engineered frontend time parsing logic with strict regex normalization to guarantee flawless UTC-to-local conversions across all browsers.

🛡️ Backend Improvements

Unrestricted Query Discovery: Removed strict legacy attribute filters in the backend trace repository. The system will now correctly identify and export any slow span that matches your time and duration filters, rather than silently ignoring queries without external HTTP or Database attributes.
Multi-Database Support: The new export logic works flawlessly whether your backend is configured to use MongoDB Atlas or MySQL.

🛠️ Upgrade Instructions No database schema migrations are required for this release. Simply pull the latest Docker image, or if running locally, pull the latest changes.

🤝 Contributors

Built with ❤️ by @priyanshumodi22.

If you like kubiq, please give us a star on GitHub! ⭐

v2.0.0

May 18, 2026

kubiq v2.0.0 - The Kubernetes Era

Welcome to kubiq v2.0.0! This is our first major version release, introducing a massive, commercial-grade Kubernetes Cluster Explorer to kubiq.

We have completely expanded the scope of kubiq: transforming it from a robust server monitoring and APM tool into an all-in-one, high-performance, and visually stunning Kubernetes management control plane (competing directly with Lens and Portainer).

🌐 Official Website & Documentation

⚡ What's New inside the Kubernetes Dashboard

1. 🔌 Multi-Cluster Context Switching

Take control of all your clusters from a single, unified menu.

Automatic Discovery: Automatically reads and parses your active Kubeconfig contexts on boot.
Smart Prettification: Auto-formats long, raw AWS EKS, Google GKE, and Azure AKS context strings into clean, beautiful tags (e.g. arn:aws:eks:.../dev-cluster becomes dev-cluster [EKS:us-east-1]).
Custom Glassmorphic Tooltip Card: Hovering over any cluster context triggers a breathtaking connection inspector card displaying the active cloud provider, authentication user, raw ARN identifiers, and backend target API endpoints.
Perfect UI Scaling: A compact 240px selector bar that handles text truncation seamlessly, accompanied by a dynamic sidebar layout ensuring zero overlap.

2. 🗺️ Relationship Mapping (Service Topology Map)

A mathematically aligned, pixel-perfect visual dependencies map representing your entire namespace.

4-Column Dependency Graph: Visualizes live connections from entry points to secure parameters: Hosts & Ingresses ➡️ Services (ClusterPorts) ➡️ Pod Replicas ➡️ Configs/Secrets
Single-Transform Canvas Wrapper: Combines SVG graphics and DOM node cards into a synchronized transformation wrapper. Guarantees 100% pixel-perfect alignment under zooming, panning, dragging, and resizing.
Natural Bezier Curves: Employs sloping diagonal math (dx * 0.3) to prevent paths from collapsing into sharp vertical lines.
Active Trace Highlighting: Hovering over any card highlights its immediate upstream inputs and downstream outputs in a gorgeous glowing Cyan (#00f0ff) trace trail.

3. 📝 Direct YAML Manifest Editing (Monaco Editor)

Inspect, patch, and deploy cluster resources on-the-fly inside the browser.

Integrated Monaco Engine: Features a full-scale, VS Code-powered Monaco Editor embedded directly in a slide-out drawer.
JSON/YAML Schema Validation: Built-in syntax highlighting, searching, and schema alignment.
Hot-Patch Deployment: A single click compiles your edits, sends them to a secure backend manifest parser, and executes a live k8sService.applyResource(manifest) hot-patch directly.

4. 💻 Interactive Pod Container Shell (Exec TTY)

Open secure, fully interactive container terminals directly from your dashboard.

Styled Xterm.js Canvas: Embedded terminal console with customized fonts, emerald cursors, and full support for keyboard events, arrows, tabs, and backspaces.
Multi-Container Selectors: Dropdown switching for pods containing multiple sidecars or containers.
PTY Stream Management: Backend terminal streaming service spawns container sessions asynchronously via standard Kubernetes API Exec streams with dynamic window resizing.

5. 📡 Real-Time Namespace Observability & Events

Pod Micro-Sparklines: Real-time inline CPU and memory historical metrics powered by Recharts.
Interactive Namespace Dashboard: Radial progress gauges representing pod health, total aggregations, and consumption limits.
Live Event Watcher Feed: A stream displaying namespace alerts, schedule failures (FailedScheduling), and crash cycles (OOMKilled, CrashLoopBackOff) in an active alarm center.
Workload Quick Actions: UI controls to trigger rolling restarts, deployment scaling, and safe deletions directly from cards.

🔒 Under the Hood Enhancements

WebSocket log stream backpressure: Batches and buffers streaming log emissions in 100ms intervals to prevent browser threads from choking during high-throughput log cascades.
Shared Room Log Watcher: Multiple clients viewing the same pod log room now share a single active file handle, preventing file system leaks.
Zero-Dependency Setup: Hot-reloading client contexts dynamically rebuilds internal client SDK parameters without requiring a node reboot.

🚀 Quick Start (Docker v2.0.0)

Setup your environment: Grab your latest .env file containing Kubeconfig paths from kubiq.priyanshumodi.in/view/env.

Mount Kubeconfig & Run kubiq:

For Local/On-Premise Clusters:

docker run -d \
  --name kubiq \
  -p 3001:3001 \
  -v ~/.kube:/root/.kube:ro \
  -v kubiq-data:/app/data \
  --env-file .env \
  --restart unless-stopped \
  priyanshumodi22/kubiq:latest

For Managed Cloud Clusters (AWS EKS, Azure AKS, Google GKE):

docker run -d \
  --name kubiq \
  --network host \
  -e KUBECONFIG=/root/.kube/config \
  -v ~/.kube:/root/.kube:ro \
  -v ~/.aws:/root/.aws:ro \
  -v ~/.azure:/root/.azure:ro \
  -v ~/.config/gcloud:/root/.config/gcloud:ro \
  -v kubiq-data:/app/data \
  --env-file .env \
  --restart unless-stopped \
  priyanshumodi22/kubiq:latest

🤝 Contributors

Built with ❤️ by @priyanshumodi22.

If you like kubiq, please give us a star on GitHub! ⭐

v1.2.0

May 13, 2026

kubiq v1.2.0 - The Observability Release

🚀 Overview

Release v1.2.0 is a major update focused on observability filtering, trace accuracy, and overall dashboard reliability. This release introduces powerful new ways to filter traces and ensures that high-volume background noise (like health checks) is accurately dropped before it hits your database.

✨ Major Features & Enhancements

Global Ingestion Filtering: You can now configure system-wide ignored routes (e.g., /health, /metrics). kubiq APM will now intelligently drop the entire trace tree associated with these routes, drastically reducing database storage costs and dashboard noise.
Advanced Trace Search & Filtering: The Trace Inspector has been upgraded to support strict faceted searching. You can now instantly filter traces by route attributes (e.g., /checkout), enforce Latency thresholds (e.g., > 2s), and toggle "Errors Only" to instantly isolate failing requests.
Refined Trace Inspector UI: The APM Dashboard has received a visual polish. Trace selection dropdowns and filter menus now feature a premium, dynamic design with integrated status indicators and color-coded icons for immediate visual feedback.

🐛 Bug Fixes

Orphaned Span Leakage: Fixed a critical bug where ignoring a route would drop the root span, but child spans (e.g., database queries made by the health check) would still leak into the dashboard. The system now guarantees 100% trace tree dropping for ignored configurations.
Cross-Database Search Consistency: Resolved an issue where searching for specific trace attributes (like a route path) would fail to return results when using MongoDB. Search behavior is now fully unified and reliable across both Mongo and MySQL backend adapters.
Stale Trace Waterfalls: Fixed a visual bug where the Trace Waterfall component would remain stuck on the screen even after a user applied a filter (like "Errors Only") that excluded the trace they were currently looking at.
Span Inspector Layout: Fixed a layout issue where the Span Details modal would get squashed, cut off, or become unreadable when inspecting very short traces. The modal now consistently renders at full viewport height.

🛠️ Upgrade Instructions

No database schema migrations are required for this release. Simply pull the latest changes, rebuild the frontend assets, and restart the backend ingestion service.

v1.1.0

May 10, 2026

kubiq v1.1.0 - The Reliability Release

A massive infrastructure update focused on Enterprise-Grade Stability. This release introduces alert debouncing to stop notification spam, hardens the notification delivery system, and features a completely rewritten, high-performance log streaming engine.

🌐 Official Website

✨ What's New

🤫 Alert Debouncing (Anti-Flapping)

Say goodbye to alert spam caused by 1-second network glitches.

Retries before alerting: You can now configure a custom failure threshold per-service directly from the UI.
The monitoring engine tracks consecutive failures. If a service drops a ping but succeeds on the next try, no alert is sent.
A service is only marked as Unhealthy if it fails N consecutive times (defaults to 3).

🛡️ Stability & Performance Upgrades

⚡ High-Performance Log Streaming

The backend log watcher has been completely overhauled to handle massive enterprise log files without freezing the dashboard.

Shared Watcher Pattern: Fixed severe memory leaks by ensuring 10 users viewing the same log share exactly 1 file watcher via Socket.IO rooms.
Backpressure Handling: Log lines are now buffered and batched in 100ms intervals (or 64KB chunks), preventing browser UI crashes during high-throughput log explosions.
Event-Loop Safe: Replaced blocking synchronous file scans with asynchronous promises.

✉️ Notification Engine Hardening

Your alerts are now guaranteed to deliver, faster than ever.

Exponential Backoff Retries: If Discord webhooks or your SMTP server drops the connection, Kubiq will automatically retry sending the alert 3 times (with 1s, 2s, and 4s delays).
SMTP Caching: Email connections are now cached and reused, bringing CPU load and alert latency down to near-zero.
Webhook Timeouts: Implemented strict 5-second timeouts on webhooks to prevent bad URLs from hanging the Node server indefinitely.

🚀 Quick Start (Docker)

Setup your environment: Grab the .env.example from our website (kubiq.priyanshumodi.in/view/env) and save it as .env.
Run kubiq:

docker run -d \
  --name kubiq \
  -p 3000:3000 \
  -v kubiq-data:/app/data \
  --env-file .env \
  --restart unless-stopped \
  priyanshumodi22/kubiq:latest

📦 Changes in this Release

Added retries field to Add and Edit service modals (defaults to 3).
Added failure counting and debouncing logic to the core ServiceMonitor engine.
Rewrote LogStreamService.ts to implement Socket.IO rooms, reference counting, and buffered batch emissions.
Added withRetry, SMTP caching, and axios timeouts to NotificationManager.ts.
Added automatic MySQL ALTER TABLE schema migrations on boot.
Fixed a bug in JsonServiceRepository where custom poll intervals were lost upon server restart.

🤝 Contributors

Built with ❤️ by @priyanshumodi22.

If you like kubiq, please give us a star on GitHub! ⭐

v1.0.1

Apr 23, 2026

kubiq v1.0.1 - Patch Release

A focused patch release bringing per-service polling control, UI consistency improvements, and security patches across the stack.

🌐 Official Website

✨ What's New

⏱️ Per-Service Check Intervals

You can now configure a custom polling interval per service directly from the dashboard — no more editing the database manually.

Set each service to check every 10s, 30s, 1m, 5m, or 10m independently.
Interval is stored in the database and respected by the monitoring engine on every cycle.
The global POLL_INTERVAL environment variable now acts as the fallback for services with no custom interval set.

🎨 Native UI Dropdowns Replaced

All native browser <select> dropdowns have been replaced with consistent, dark-themed custom dropdowns:

Add / Edit Service modal — Check Interval selector.
APM & Traces page — Time range filter (Last 15 min / 1h / 24h).
User Management page — Role selector (Viewer / Admin).

🔒 Security Patches

Resolved 43 npm audit vulnerabilities across the frontend and backend (down to 1 unfixable pkg dev-tool advisory):

Package	Severity	Fix
`fast-xml-parser`	Critical	Upgraded via `@aws-sdk` chain
`handlebars`	Critical	Patched
`axios`	High	Upgraded to latest
`vite`	High	Upgraded
`rollup`	High	Upgraded
`systeminformation`	High	Upgraded
`path-to-regexp`	High	Upgraded
`socket.io-parser`	High	Upgraded
`nodemailer`	Moderate	Upgraded to `8.0.5`
`lodash`, `minimatch`, `picomatch`, `flatted`, `brace-expansion`	High / Moderate	Patched

🚀 Quick Start (Docker)

Setup your environment: Grab the .env.example from our website (kubiq.priyanshumodi.in/view/env) and save it as .env.
Run kubiq:

docker run -d \
  --name kubiq \
  -p 3000:3000 \
  -v kubiq-data:/app/data \
  --env-file .env \
  --restart unless-stopped \
  priyanshumodi22/kubiq:v1.0.1

📦 Changes in this Release

Added per-service interval field to Add and Edit service modals (frontend + API routes).
Replaced all native <select> dropdowns with custom dark portal dropdowns (no OS-default styling).
Fixed dropdown overflow clipping inside modals using createPortal with position: fixed.
Patched 43 npm audit vulnerabilities across frontend and backend packages.
Bumped nodemailer from ^7.0.12 → ^8.0.5.

🤝 Contributors

Built with ❤️ by @priyanshumodi22.

If you like kubiq, please give us a star on GitHub! ⭐

v1.0.0

Mar 11, 2026

kubiq v1.0.0 - Public Launch

We are thrilled to announce the first public release of kubiq! 🚀

kubiq is a modern, lightweight, and self-hosted monitoring solution designed to give you real-time visibility into your infrastructure without the bloat. Whether you're running a single VPS or a cluster of nodes, kubiq keeps you informed.

🌐 Official Website

Check out our brand new website for documentation, comparisons, and more: 👉 https://kubiq.priyanshumodi.in/

✨ Key Features

⚡ Real-Time Streaming & Monitoring:
- HTTP/HTTPS: Website & API uptime with SSL Expiration Monitoring.
- TCP: Port monitoring for raw services (Redis, SSH, Custom).
- Databases: Native connectivity checks for MySQL & MongoDB.
- Logs: Live stream via Socket.IO.
🛠️ Built-in API Testing: Test your HTTP/HTTPS APIs directly from the kubiq dashboard, just like Postman.
📝 Advanced Log Management: Stream logs live with Glob Pattern Support (e.g., /var/log/*.error) and auto-rotation handling.
📈 System Analytics:
- Animated gauges for CPU, RAM, & Disk Usage.
- 📉 Predictive Storage Analytics: Intelligent "Days Remaining" forecast to predict when your disk will be full based on usage trends.
🔗 Distributed APM & Tracing:
- kubiq-apm: Zero-config NPM package for auto-instrumenting Node.js apps via OpenTelemetry.
- Metrics Grid: Real-time service overviews showing Throughput (RPM), P95 Latency, and Error Rates.
- Topology Map: Auto-generated, interactive visual map of service dependencies and network architectures.
- Trace Inspector: Granular tracing with a detailed Trace Waterfall to pinpoint bottlenecks and query latencies.
💾 Multi-Database Support: Flexible storage:
- JSON (Default, zero-config)
- MySQL & MongoDB (Enterprise scaling)
🔐 Triple-Layer Security:
- Native Auth: JWT-based secure login.
- WebAuthn: Passwordless login with Passkeys (FaceID, TouchID, YubiKey).
- OIDC / Keycloak: Enterprise SSO integration.
- RBAC: Admin (Read/Write) & Viewer (Read-Only) roles.
🔔 Smart Notifications: Alerts via SMTP (Email) or Webhooks (Discord, Slack, Teams).
🖥️ Cross-Platform: Native support for AMD64 and ARM64.

🚀 Quick Start (Docker)

Setup your environment: First, grab the complete .env.example file from our website (kubiq.priyanshumodi.in/view/env) and save it locally as .env.
Run kubiq:

docker run -d \
  --name kubiq \
  -p 3000:3000 \
  -v kubiq-data:/app/data \
  --env-file .env \
  --restart unless-stopped \
  priyanshumodi22/kubiq:latest

📦 Changes in this Release

Initial public release.
Complete UI overhaul for the dashboard.
Launched official documentation website.
Implemented dynamic license modal on the website.
Added Docker Compose support (check website/docs).

🤝 Contributors

Built with ❤️ by @priyanshumodi22.

If you like kubiq, please give us a star on GitHub! ⭐