Dashboard Overview

The FlatRun UI is a modern web dashboard for managing your Docker deployments. This guide covers the main features and how to navigate the interface.

Accessing the Dashboard

After installing the UI (see Installation), access it via your configured domain or IP address. You'll be greeted with the login screen.

Authentication

1. Enter your API key (configured in the agent's auth.api_keys)
2. Click "Login"
3. You'll be redirected to the home dashboard

Main Navigation

The sidebar provides access to all major sections:

Home Dashboard

The home dashboard provides a quick overview:

• Statistics Cards — Total deployments, running containers, etc.
• Recent Deployments — Quick access to your latest deployments
• System Status — Agent health and version information

Common UI Patterns

Data Tables

Most list views use data tables with these features:

• Search — Filter items by name or other attributes
• Sorting — Click column headers to sort
• View Toggle — Switch between table and grid views
• Bulk Selection — Select multiple items for batch operations
• Actions — Per-item action buttons (start, stop, delete, etc.)

Status Indicators

Color-coded status badges throughout the UI:

• Running — Service is running normally
• Stopped — Service is stopped
• Error — Service has an error
• Healthy — Health check passing
• Unhealthy — Health check failing

Modal Dialogs

Many operations use modal dialogs:

• New Deployment — Wizard for creating deployments
• Confirmation — Confirm destructive actions
• Details — View logs, stats, and other details

Toast Notifications

Operations display toast notifications to indicate success or failure. These appear in the bottom-right corner and auto-dismiss after a few seconds.

Quick Actions

Common actions available from multiple places:

Create New Deployment

Click the "New Deployment" button (available on Home and Deployments pages) to open the deployment wizard:

1. Easy Mode — Select from templates, configure basic options
2. Compose Mode — Write custom docker-compose.yml

Start/Stop Deployments

Control deployment lifecycle from:

• Deployment list — Action buttons in each row
• Deployment detail — Control buttons at the top
• Bulk select — Select multiple and use bulk actions

View Logs

Access logs from:

• Deployment detail → Logs tab
• Container list → Logs action
• Infrastructure services → Logs button

Responsive Design

The UI is responsive and works on mobile devices. On smaller screens:

• Sidebar collapses to a hamburger menu
• Tables become scrollable
• Grid views adjust column count

Keyboard Shortcuts

Some common keyboard shortcuts: