Quick Start¶

This guide will get you up and running with k13d in under 5 minutes.

Prerequisites¶

Before you begin, ensure you have:

• A running Kubernetes cluster
• kubectl configured and working (kubectl get nodes should work)
• k13d installed (Installation Guide)

Step 1: Start k13d¶

# Default mode - opens terminal dashboard
./k13d

# Start web server
./k13d -web -port 8080

# Open in browser
open http://localhost:8080

Step 2: Navigate Resources¶

TUI Navigation¶

Web Navigation¶

1. Use the sidebar to select resource types
2. Click on a resource to view details
3. Use the AI chat panel on the right for assistance

Step 3: Try the AI Assistant¶

Press Tab (TUI) or use the chat panel (Web) to open the AI assistant.

Try these example prompts:

Show me pods that are not running

What deployments are in the default namespace?

Explain why this pod is in CrashLoopBackOff

The AI will:

1. Understand your request
2. Execute the appropriate kubectl commands
3. Provide a clear explanation

Step 4: Configure LLM (Optional)¶

For the best AI experience, configure an LLM provider:

llm:
  provider: solar
  model: solar-pro2
  endpoint: https://api.upstage.ai/v1
  api_key: your-upstage-api-key

llm:
  provider: openai
  model: gpt-4
  api_key: your-openai-api-key

# Start Ollama first
ollama pull qwen2.5:3b

llm:
  provider: ollama
  model: qwen2.5:3b
  endpoint: http://localhost:11434/v1

Common Operations¶

View Pod Logs¶

Show me the logs for pod nginx-xxx

Scale a Deployment¶

Scale deployment nginx to 3 replicas

Describe a Resource¶

Describe deployment nginx

Next Steps¶