Web Dashboard¶

The Web Dashboard provides a modern browser-based interface for Kubernetes management with full AI integration.

Overview¶

The Web UI offers:

• Modern Interface: Responsive design with dark/light themes
• Real-time Updates: Live resource status updates
• AI Assistant: Integrated chat interface
• Multi-cluster: Switch between contexts
• Reports: Generate cluster analysis reports

Getting Started¶

Launch Web Mode¶

# Start web server on default port 8080
k13d -web

# Specify custom port
k13d -web -port 3000

# With authentication
k13d -web -password "your-secure-password"

# With embedded LLM (no API key needed)
k13d -web --embedded-llm

Access the Dashboard¶

Open your browser to: http://localhost:8080

Interface Layout¶

┌─────────────────────────────────────────────────────────────────┐
│ k13d │ Context: prod │ Namespace: default │ [Settings] [Help]  │
├───────────┬─────────────────────────────────────────────────────┤
│           │                                                     │
│ Resources │  Resource Table                                     │
│ ─────────│                                                     │
│ Pods      │  NAME         READY  STATUS   AGE                  │
│ Services  │  nginx-abc    1/1    Running  2d                   │
│ Deploys   │  api-def      2/2    Running  5d                   │
│ ConfigMaps│                                                     │
│ Secrets   │                                                     │
│ ...       │                                                     │
│           │                                                     │
├───────────┴─────────────────────────────────────────────────────┤
│ AI Assistant                                                     │
│ ───────────────────────────────────────────────────────────────│
│ Ask me anything about your cluster...                           │
│ [Send]                                                           │
└─────────────────────────────────────────────────────────────────┘

Navigation¶

Sidebar¶

Resource Table¶

• Click row to view details
• Search bar for filtering
• Namespace dropdown for switching
• Refresh button for manual refresh

Resource Actions¶

Right-Click Menu¶

Right-click on any resource to see available actions:

Quick Actions¶

AI Assistant¶

Chat Interface¶

1. Type your question in the input field
2. Click "Send" or press Enter
3. View streaming response
4. Approve/reject tool requests

Example Queries¶

"Why is my nginx pod crashing?"
"Scale the api deployment to 5 replicas"
"Show me all pods with high CPU usage"
"Explain this HPA configuration"

Tool Approval¶

When AI needs to execute a command:

┌──────────────────────────────────────┐
│ Tool Approval Required                │
│                                      │
│ kubectl get pods -n production       │
│                                      │
│ [Approve]  [Reject]                  │
└──────────────────────────────────────┘

Features¶

Dark/Light Theme¶

Toggle theme in Settings or click the theme icon in the header.

Real-time Updates¶

Resources update automatically. Configure refresh interval:

Settings → General → Refresh Interval

Keyboard Shortcuts¶

Settings¶

LLM Configuration¶

Settings → AI → LLM Configuration

MCP Servers¶

Settings → AI → MCP Servers

Manage external MCP servers for extended AI capabilities.

User Management¶

Settings → Admin → Users

Reports¶

Generate comprehensive cluster reports with selectable sections:

1. Navigate to Reports section
2. Select report type:
3. Cluster Overview - General health
4. Security Audit - Security findings
5. Cost Analysis - Resource costs
6. Choose which sections to include (Nodes, Namespaces, Workloads, Events, Security, FinOps, Metrics)
7. Configure options:
8. Namespace filter
9. Output format
10. Click "Generate"

Custom Resource Detail¶

Click on any Custom Resource to view a rich detail modal:

• Overview tab with auto-detected status, metadata, key fields, spec/status summary, conditions table, labels, and annotations
• YAML tab with full manifest
• Events tab with related Kubernetes events

Pod Actions¶

View Logs¶

1. Click on a pod
2. Select container (if multiple)
3. View streaming logs
4. Options:
5. Previous logs
6. Follow
7. Timestamps
8. Download

Execute Shell¶

1. Click on a pod
2. Click "Exec" or 🖥️ icon
3. Select container
4. Enter commands in terminal

Port Forward¶

1. Click on a pod
2. Click "Port Forward"
3. Configure:
4. Local port
5. Container port
6. Click "Start"
7. Access at localhost:<port>

Deployment Actions¶

Scale¶

1. Select deployment
2. Click "Scale" or use slider
3. Enter replica count
4. Confirm

Restart¶

1. Select deployment
2. Click "Restart"
3. Confirm rollout restart

Rollback¶

1. Select deployment
2. Click "Rollback"
3. Select revision
4. Confirm

Node Actions¶

Cordon/Uncordon¶

1. Select node
2. Click "Cordon" to prevent scheduling
3. Click "Uncordon" to allow scheduling

Drain¶

1. Select node
2. Click "Drain"
3. Configure options:
4. Ignore DaemonSets
5. Delete local data
6. Force
7. Confirm

API Access¶

The Web UI exposes REST APIs:

# Get pods
curl http://localhost:8080/api/k8s/pods

# With authentication
curl -H "Authorization: Bearer $TOKEN" \
     http://localhost:8080/api/k8s/pods

# AI chat
curl -X POST http://localhost:8080/api/chat/agentic \
     -H "Content-Type: application/json" \
     -d '{"message": "list pods"}'

Mobile Support¶

The Web UI is responsive and works on mobile devices:

• Touch-friendly navigation
• Swipe gestures
• Collapsible panels
• Optimized for smaller screens

Security¶

Authentication¶

Enable password authentication:

k13d -web -password "secure-password"

Or in config:

auth:
  password: "secure-password"

HTTPS¶

For production, use a reverse proxy (nginx, traefik) with TLS.

Troubleshooting¶

WebSocket Connection Failed¶

• Check if port is accessible
• Verify no firewall blocking
• Try different browser

Slow Performance¶

• Reduce refresh interval
• Limit namespace scope
• Use filters to reduce data

AI Not Responding¶

• Check LLM configuration
• Verify API key
• Check network connectivity

Next Steps¶

• TUI Dashboard - Terminal interface
• Keyboard Shortcuts - All shortcuts
• Configuration - Full options