Nimbus — Minecraft Cloud System

The Web Dashboard is currently in BETA. Features may change, and bugs are expected. Report issues on GitHub.

The Nimbus Web Dashboard is a browser-based management UI that connects to your controller's REST API. It provides a visual interface for everything you can do from the console — service management, group configuration, plugin installation, stress testing, and more.

The dashboard is live at dashboard.nimbuspowered.org.

How It Works

The dashboard is a static Next.js application that runs entirely in your browser. When you log in, it connects directly to your Nimbus controller's API — no data passes through any third-party server. Your API token is stored in your browser's local storage.

Architecture

┌─────────────┐        HTTPS / WSS        ┌──────────────────┐
│  Dashboard   │  ◄──────────────────────► │ Nimbus Controller │
│  (Browser)   │    REST API + WebSocket   │   (your server)   │
└─────────────┘                            └──────────────────┘

Connecting

Open dashboard.nimbuspowered.org in your browser
Enter your controller's API URL (e.g., http://your-server:8080 or https://api.your-domain.com)
Enter your API token (shown in the console on startup, or set permanently in nimbus.toml)
Click Connect

Your API must be reachable from your browser. If your controller runs on a remote server, ensure port 8080 (or your configured API port) is open and accessible. For production use, we recommend putting the API behind a reverse proxy with HTTPS.

Finding Your API Token

If you haven't set a permanent token, Nimbus auto-generates one on each start and logs the first 8 characters to the console. To set a permanent token:

config/nimbus.toml

[api]
enabled = true
bind = "0.0.0.0"
port = 8080
token = "your-secret-token"

You can also use the api console command to view the current token:

Console

nimbus » api token

Features

Service Overview

The dashboard home page shows all running services with live status, player counts, ports, and uptime. Services are color-coded by state (READY, STARTING, STOPPING, CRASHED).

Group Management

View all server groups, their configuration, and running instances. Create new groups or modify existing ones directly from the dashboard.

Real-Time Console

Attach to any service's console output with full ANSI color rendering. Send commands to services interactively — the same experience as screen <service> in the console.

Plugin Management

Search for plugins on Hangar and Modrinth, view details, and install them to any group's template — all from the browser. The same functionality as the plugins console command.

Modpack Import

Import modpacks from Modrinth, CurseForge, or upload a server pack ZIP. Two modes: enter a slug/URL to fetch from a platform, or drag-and-drop a server pack ZIP file. Configure group type (Static/Dynamic), memory, and scaling before importing.

Stress Testing

Start, stop, and monitor stress tests. View per-service simulated player distribution and total capacity in real time.

Audit Log

Browse the full audit trail with filters by action type and actor. See who did what and when.

Dedicated Services

Manage dedicated services (single-instance, fixed-port) — create, start/stop, edit, delete, and import modpacks. Same workflow as groups but without templates or scaling.

Node Management

Monitor connected agent nodes in multi-node clusters. Each node shows system specs (CPU, RAM, OS, Java), live CPU/memory usage bars, connected status, and agent version. Auto-refreshes every 5 seconds.

Cluster Topology

Interactive Railway-style topology canvas showing the controller, agent nodes, and all services. Draggable card nodes with CPU/memory meters, heartbeat pulse animations, and obstacle-aware edge routing. Pan/zoom with mouse or keyboard (+/-/0/F/arrows).

Module Configuration

Configure Display (signs + NPCs), Permissions, Players, and SyncProxy (MOTD, tab list, chat) modules through visual forms instead of editing TOML files.

Metrics & Charts

Per-service memory history charts with 30-second sampling. Memory bars with tone-coded pressure (green → yellow → red). Historical data pre-loaded on page mount — no more blank charts.

Overview & System Telemetry

The Overview page shows controller host system stats (CPU, RAM, OS, Java), Nimbus runtime info (memory budget, uptime, version), service summary, and a "What's new" accordion with the latest changelog.

Light / Dark Theme

Toggle between light and dark themes via the header button. Respects system preference by default, remembers your choice.

CORS Configuration

The dashboard at dashboard.nimbuspowered.org is pre-configured in the default CORS allowlist. If you host the dashboard yourself or use a custom domain, add it to the CORS origins in nimbus.toml:

config/nimbus.toml

[api]
allowed_origins = ["https://dashboard.nimbuspowered.org", "https://your-custom-domain.com"]

Self-Hosting

The dashboard source code is in the dashboard/ directory of the Nimbus repository. You can build and host it yourself:

Terminal

cd dashboard
npm install
npm run build

The output is a static site that can be deployed to any web host (Vercel, Netlify, Cloudflare Pages, or your own Nginx).

Security

Your API token is stored in your browser's local storage — treat it like a password
All API communication happens directly between your browser and your controller
For production use, enable HTTPS on your API (via reverse proxy) to encrypt token transmission
Consider using JWT scoped tokens (jwt_enabled = true) for fine-grained access control

Web Dashboard

On this page