Dashboard Setup

Set up and navigate the Medusa web dashboard for browser-based bot management and configuration.

Medusa comes with a full web management dashboard. Administrators and staff can configure modules, inspect audit logs, view console streams, manage commands, and design Discord embeds directly from the browser.

Dashboard Architecture

The dashboard is built using modern Next.js and React. It communicates directly with Medusa's internal REST API using bearer-token authentication.

Dashboard Port: Configured in SERVER.DASHBOARD.PORT in config.json (default 3000).
Internal API Port: Configured in SERVER.API.PORT in config.json (default 3001).
Schema-Driven UI: All module settings, options, and capabilities are registered through the internal API dynamically. No manual dashboard code changes are needed when modules are enabled or updated.

1. Configure the Setup User

In your config.json, locate the SETUP_USER field and set it to your personal Discord User ID:

"SETUP_USER": "764868946523324457"

The user matching this ID receives unconditional administrator authority upon initial sign-in, allowing you to configure further permissions and staff ranks.

2. Verify Discord OAuth2 Settings

Ensure your Discord OAuth2 redirect URI is registered in the Discord Developer Portal:

Open your Discord Application in the developer portal.
Go to OAuth2.
Under Redirects, add your callback address:
- For local testing: http://localhost:3000/api/auth/callback/discord
- For production / remote servers: https://your-domain.com/api/auth/callback/discord (or http://SERVER_IP:3000/api/auth/callback/discord)
Save changes.

Bot latency, gateway heartbeat, and uptime.
Real-time memory consumption and process statistics.
Total guild members, voice sessions, and channels.
Status breakdown of all 22 loaded and active modules.

2. Live Console

Inspect runtime output in real time without accessing terminal SSH:

Formatted log levels: [ SRT ] startup, [ INF ] info, [ SUC ] success, [ WAR ] warning, and [ ERR ] error.
Automatic redaction of sensitive license keys and API secrets.
Filter logs by level or search for specific event strings.

3. Module Manager

Enable or disable any of Medusa's 22 modules with a single toggle:

Changes take effect instantly without restarting the bot process.
Non-essential modules can be completely switched off to conserve memory.
Every state change is recorded automatically in the audit log.

4. Configuration Editor

Each module provides a dynamic configuration schema:

Modify moderation thresholds, economy parameters, welcome messages, and ticket channels.
Inputs include role pickers, channel dropdowns, color pickers, text fields, and switches.
Changes persist directly to the PostgreSQL database and apply immediately to Discord interactions.

5. Command Manager

Manage your entire command hierarchy:

Set global text command prefixes (default: !).
Toggle individual commands between slash commands, prefix commands, or both.
Assign custom prefix shortcuts for specific commands (e.g. ;ban instead of !ban).
Enforce baseline rank permissions required to invoke commands.

6. Interactive Embed & Message Builder

Design Discord messages with a live visual preview:

Build single or multi-embed messages with custom titles, descriptions, footers, and timestamps.
Add action buttons with custom styles (Primary, Secondary, Success, Danger, Link).
Attach dropdown select menus and Discord Components V2.
Dispatch directly to any server channel or save as reusable templates.

7. Staff Permissions (RBAC)

Create hierarchical permission ranks for your moderation and administration team:

Assign Discord roles to ranks with specific priority levels.
Grant granular access to individual dashboard tabs (e.g. allow moderators into Moderation and Tickets while reserving Security and Economy for executives).
Restrict command execution and log visibility based on assigned ranks.

8. Audit Logs

Review all administrative actions with rich contextual details:

Tracks who changed a setting, toggled a module, issued a punishment, or sent a broadcast.
Includes timestamp, actor tag, target guild, command executed, and change diffs.