Skip to main content
Having issues with Agent Stack? Here are the most common fixes:

​
Quick Fixes

​
Restart the Platform

agentstack platform stop
agentstack platform start

​
Update to Latest Version

Make sure you have the latest version: 
uv tool install --force agentstack-cli
agentstack platform start

​
Check Your LLM Setup

Agents need LLM configuration to work: 
agentstack model setup

​
Using Ollama? Pull Your Model

If using Ollama, make sure it’s installed and the model is pulled: 
ollama pull llama3.1:8b

​
Advanced debugging

You can inspect the agent logs and events using agentstack logs <agent-name> or you can access the kubernetes cluster directly using agentstack platform exec, for example: 
# List running pods
agentstack platform exec kubectl get pod

# Get server logs
agentstack platform exec kubectl logs svc/agentstack-server-svc

# Inspect cluster using GUI
export KUBECONFIG=~/.agentstack/lima/agentstack/copied-from-guest/kubeconfig.yaml
k9s

​
Get Help

Still stuck?