Troubleshooting

Start with:

kibaco doctor

doctor checks:

  • Active config file
  • Proxy port availability
  • Reusable Kibaco proxy state
  • Docker availability
  • Service references
  • Project working directories
  • Kibaco CLI Node and project Node version pins
  • Missing asdf Node installs or missing pnpm for the pinned Node
  • Target port and reachability

Common Fixes

Port conflict:

kibaco kill-port 8080 --force

Stop Docker services:

kibaco services down

Check service logs:

kibaco services logs postgres --follow