packages/docs/apps/dashboard.md
The Eliza web dashboard is the primary interface for interacting with your agent. It provides a full-featured control panel for chatting, configuring your agent's character, managing plugins, and monitoring runtime behavior.
The dashboard runs as a web application served by the Eliza agent runtime.
| Method | Details |
|---|---|
| Default URL | http://localhost:2138 |
| CLI shortcut | Run eliza dashboard to open the dashboard in your default browser |
| Desktop app | The Electrobun desktop app embeds the dashboard directly (no browser required) |
On first launch you will see the server chooser / startup flow. If the selected server still needs setup, Eliza continues into onboarding for that server before you reach the main dashboard. If authentication is required you will see the Pairing View before reaching the main dashboard.
<Info> The dashboard port defaults to `2138`. If this port is already in use, the runtime will log the actual port it binds to. Check the startup logs for the exact URL. </Info>The dashboard uses a tab-based navigation system. On the Chat tab, the layout includes a Conversations Sidebar on the left, the Chat View in the center, and an Autonomous Panel on the right. On mobile viewports (below 1024 px), the sidebar and autonomous panel collapse into overlay buttons.
A Header bar sits at the top of every page, and a Terminal Panel is available at the bottom. A Command Palette (Cmd/Ctrl+K in the desktop app) provides quick access to actions across the dashboard.
The header displays across all tabs and includes:
agentStatus.agentName.The dashboard adapts to viewport width:
| Viewport | Behavior |
|---|---|
| Desktop (1024 px and above) | Full three-column layout: sidebar, chat, autonomous panel |
| Tablet (768-1023 px) | Sidebar and autonomous panel collapse to overlay toggles |
| Mobile (below 768 px) | Single-column layout; sidebar and panel open as full-screen overlays |
The ConversationsSidebar and AutonomousPanel components both accept a mobile prop that switches their rendering mode and adds a close button.
The navigation is organized into primary tabs and an Advanced group:
| Tab Group | Tabs | URL Path |
|---|---|---|
| Chat | chat | /chat |
| Character | character | /character |
| Wallets | wallets | /wallets |
| Knowledge | knowledge | /knowledge |
| Social | connectors | /connectors |
| Apps | apps | /apps |
| Settings | settings | /settings |
| Advanced | plugins, skills, actions, triggers, fine-tuning, trajectories, runtime, database, logs, security | Various |
Legacy paths are redirected automatically: /game maps to Apps, /agent to Character, /inventory to Wallets, /features to Plugins, /admin to Advanced, and /config to Settings.
The default landing tab — a full messaging interface with voice chat, 3D avatar, conversation management, and autonomous monitoring.
<Card title="Chat Documentation" icon="message" href="/dashboard/chat"> Full Chat tab documentation — message area, voice chat, VRM avatar, conversations sidebar, autonomous panel, emote picker, and context menu. </Card>Configure your agent through the Character hub. The view is organized into five sections:
Changes are saved via a save bar at the bottom of the view.
Displays wallet balances and NFTs. Shows token holdings across multiple EVM chains (Ethereum, Base, Arbitrum, Optimism, Polygon) and Solana. Each chain is identified with a color-coded icon.
Manage your agent's knowledge base:
Configure chat and social connector plugins. This is a filtered view of the Plugins system showing only connector-type plugins (e.g., Discord, Twitter, Telegram).
A single-surface app browser with optional full-screen game mode. Browse and launch apps that integrate with your agent, including embedded game viewers.
Canonical scrollable preferences panel implemented in the SettingsView component. The view is organized into the following sections:
Theme picker with 6 built-in themes displayed as a button grid (3 columns on mobile, 6 on desktop):
| Theme | Description |
|---|---|
| eliza | Clean black & white |
| qt3.14 | Soft pastels |
| web2000 | Green hacker vibes |
| programmer | VS Code dark |
| haxor | Terminal green |
| psycho | Pure chaos |
The active theme is highlighted. Theme selection is persisted to local storage and applied immediately. See Themes & Avatars for details.
Provider selection and model configuration via the ProviderSwitcher component. This section supports:
Embedded configuration view (ConfigPageView with embedded prop) for managing wallet addresses, RPC endpoint URLs, and secret values (API keys, tokens). This is the same configuration system available through the Config page, rendered inline within Settings.
The VoiceConfigView component configures:
The PermissionsSection component manages system permission grants for native platforms (Electrobun desktop app). Controls access to features like file system, microphone, camera, and notifications.
eliza update.ws://127.0.0.1:{port}/extension is reachable, with a green/red indicator.the current release and must be sourced separately if needed..eliza-agent file and enter the decryption password used during export.Visually separated section with red-bordered cards for irreversible actions:
The Advanced section contains specialized sub-tabs, each accessible via a secondary tab bar:
| Sub-tab | Path | Description |
|---|---|---|
| Plugins | /plugins | Feature and connector plugin management. Searchable/filterable cards with per-plugin settings and a UI Field Showcase reference plugin. |
| Skills | /skills | Custom agent skills configuration. |
| Actions | /actions | Custom agent actions -- create and edit custom action definitions. |
| Triggers | /triggers | Scheduled and event-based automation management. |
| Fine-Tuning | /fine-tuning | Dataset and model training workflows. |
| Trajectories | /trajectories | LLM call history viewer and analysis. Includes a detail view for individual trajectories. |
| Runtime | /runtime | Deep runtime object introspection and load order inspection. |
| Databases | /database | Browse database tables, media files, and vector stores. |
| Logs | /logs | Runtime and service log viewer. |
| Security | /security | Sandbox and policy audit feed. |
The dashboard displays a color-coded agent status indicator in the header. The state is derived from agentStatus.state:
| Color | States | Meaning |
|---|---|---|
Green (text-ok) | running | Agent is running normally |
Yellow (text-warn) | paused, starting, restarting | Agent is in a transitional state |
Red (text-danger) | error | Agent has encountered an error |
Gray (text-muted) | stopped, unknown, not connected | Agent status is unknown or not connected |
Plugins are managed through the Plugins sub-tab under Advanced and the Social tab for connector-type plugins:
ConfigRenderer.Transient toast notifications appear at the bottom of the screen for action confirmations, errors, and informational messages, color-coded by tone (success, error, or neutral).
When the agent needs a restart (for example, after configuration changes), a banner appears prompting you to restart. The banner uses the lifecycle control system, which tracks lifecycleBusy and lifecycleAction to prevent conflicting operations.