Troubleshooting

Common issues and how to resolve them.

ClickHouse won't start

Almost always kernel limits. Confirm vm.max_map_count=262144 and the nofile limits (Install hardening), then restart the ClickHouse service.

A checker isn't running on a lead

External checkers only run when the flow threshold or a Custom Rule needs their signal. Add the checker to a rule, or lower the threshold, to force it.

OxaPay webhook not activating a license

Callbacks aren't sent to private networks. Ensure the callback_url is public (HTTPS) and the merchant key matches, so the HMAC verifies.