Troubleshooting

Common issues and their solutions. Run jarvis doctor for automated diagnostics.

Ollama not found

Error: Cannot connect to Ollama

Solution:

curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3.2

Port already in use

Error: Port 18789 is already in use

Solution:

jarvis gateway --port 18790

Or kill the existing process and restart

Permission denied

Error: jarvis: command not found

Solution:

export PATH="$HOME/.local/bin:$PATH"

Add this to your ~/.zshrc or ~/.bashrc

Gateway won't start

Gateway fails to start or crashes immediately

Solution:

jarvis doctor
jarvis logs

Check logs for specific error messages

WhatsApp won't connect

QR code not appearing or connection fails

Solutions:

  • Make sure WhatsApp is installed on your phone
  • Check that your phone has internet connection
  • Try restarting the gateway
  • Delete ~/.jarvis/credentials/whatsapp/ and reconnect

Model not responding

AI takes too long or doesn't respond

Solutions:

  • Check if Ollama is running: ollama list
  • Try a smaller model: ollama pull llama3.2:1b
  • Check system resources (RAM, CPU)
  • Restart Ollama service

Diagnostic Commands

jarvis doctor

Run comprehensive health check

jarvis status

Check gateway and channel status

jarvis logs

View detailed logs

jarvis security audit

Run security audit

Still Having Issues?

If you're still experiencing problems:

Jarvis

© 2026 Nilkanth Desai. MIT licensed.