Skip to content

Problems

Milimarty edited this page Oct 19, 2026 · 2 revisions

Problems

Run keel2 doctor first. The most common ones:

You see Do this
"Docker is not running" start Docker Desktop (keel2 starts it on a Mac)
"not a git repository" say yes when keel2 offers git init; for a git worktree, see Git worktree projects
port 8080 is busy nothing: keel2 uses the next free port and tells you
an agent "is not logged in" Connections › Set up login
your tests start containers keel2 start --docker <folder>
"Sign in to keel" in the browser keel2 open
copying in keel TUI does nothing (macOS Terminal) /mouse off, then select

All commands: keel2 help (logs, tokens, backup, restore, uninstall …).


From docs/GUIDE.md · All pages

Clone this wiki locally