logcrux / faq


faq

does it phone home?

No. logcrux makes no network calls at run time, ever. No telemetry, no update checks, no analytics, nothing. You can verify this yourself: it's open source.

does it need root?

No. logcrux runs entirely unprivileged. It only needs read access to whatever log file you point it at.

does it work offline / air-gapped?

Yes, fully. Every piece it needs (parsers, statistical detectors, and the local classification model) ships inside the pip package. Nothing is fetched at install time beyond the package itself, and nothing is fetched at run time at all.

what license is it under?

Apache-2.0. Use it, embed it, modify it, fork it, ship it inside a commercial product. The license permits all of that, same as most serious open-source infrastructure.

what data does it store?

An optional local SQLite database (see config) for baseline event-rate tracking, stored at ~/.local/share/logcrux/state.db by default. It never leaves your machine and is entirely optional (--no-baseline).

does it require an internet connection to install?

Only to fetch the package itself, same as any pip install. Once installed, no further network access is needed.

what happens if the classification model isn't available?

logcrux degrades gracefully. The full statistical analysis still runs and is reported, with a note that classification wasn't available. It never blocks or errors out because of it.

how do I report a bug or request a format?

Open an issue on GitHub. Adding a new log format is a small, well-defined PR if you want to send one yourself.