Troubleshooting

Common Issues

"Invalid or expired token"

Cause: Access token has expired (default: 30 minutes).

Solution: Use the refresh token to get a new access token via the /api/v1/auth/refresh endpoint.

"Connection refused"

Cause: Server not running, wrong port, or firewall blocking.

Solution: Check if the process is running and verify the server.port in config.yaml.

"Database connection failed"

Cause: Database not accessible or credentials wrong.

Solution: Verify database DSN and ensure the service/file is accessible.

"Rate limit exceeded"

Cause: Too many requests from a single IP.

Solution: Implement exponential backoff in your client or adjust requests_per_second in config.