Installation¶
This section covers the prerequisites for building the sniffer and the commands needed to preview the HTML documentation locally.
Build the Sniffer¶
Use the project build guide in the repo root for the full build flow for the ACDI Sniffer:
BUILD.md
The shortest Linux path is:
./scripts/build.sh release
Expected binary:
build/pqc-sniffer
Prerequisites¶
Typical Ubuntu or Debian packages:
sudo apt-get update
sudo apt-get install -y build-essential cmake pkg-config libpcap-dev libpq-dev libpqxx-dev python3 python3-pip git
python3 -m pip install --user conan
conan profile detect --force
Preview the Docs Site Locally¶
& "C:\Program Files\Python312\python.exe" -m pip install --user -r docs-requirements.txt
& "C:\Program Files\Python312\python.exe" -m mkdocs serve
python3 -m pip install --user -r docs-requirements.txt
python3 -m mkdocs serve
Install the docs dependencies:
python3 -m pip install --user -r docs-requirements.txt
Start a local preview server:
mkdocs serve
Build static HTML files:
mkdocs build
Generated output:
site/
Recommended Publishing Flow¶
- Author or update content in
site-docs/. - Preview the site locally with
mkdocs serve. - Build static HTML with
mkdocs build. - Publish the generated
site/directory to your web host.
Scope of This Site¶
This docs site is intentionally focused on offline mode only. It does not document:
- PostgreSQL-connected deployments
- Quantum Command ingest
- database-backed telemetry workflows