Troubleshooting

Common solutions for installation, runtime, and performance issues.

Installation Issues

Runtime Issues

Dashboard Issues

Debugging

Enable Debug Mode

Set LOG_LEVEL=debug in your .env file and restart services.

Grafana Logs (Loki)

Open http://localhost:3001
Explore > Loki
Query: {service="api", level="error"}

Common Log Patterns

Pattern	Meaning
`[INFO] Notification ... delivered`	Success
`[WARN] ... failed, retrying`	Transient failure, will retry
`[ERROR] ... Invalid credentials`	Config error, requires manual fix

Distributed Deployment Issues

Configuration

Complete reference for environment variables and configuration files.

On this page

Installation Issues Runtime Issues Dashboard Issues Debugging Enable Debug Mode Grafana Logs (Loki)Common Log Patterns Distributed Deployment Issues