Troubleshooting

Common Issues

Daemon Fails to Start

Check if the port (8090 by default) is already in use.

lsof -i :8090

Database Locked

If using SQLite, ensure no other process is holding a lock on the database file.

Logs

Ratelord writes structured JSON logs to stdout. You can pipe these to `jq` for easier reading.

ratelord daemon start | jq