How to debug ClickHouse in a terminal
2025-08-24
I've been using nnd. I've only used it in Linux; MacOs is not supported. To start debugging, you'll need to build nnd (see the README) and then run:
CLICKHOUSE_WATCHDOG_ENABLE=0 ./target/dbgo/nnd ~/projects/ClickHouse/build-debug/programs/clickhouse server
Your exact path might vary, of course. And clickhouse should be a debug build.
This opens a perfectly fine TUI debugger with great mouse support and persistent breakpoints between sessions.