Quantum Wizard Server Guardian

QWSG is a local Linux Server Guardian for operators who need trustworthy, privacy-preserving evidence about server health and change. Community runs as an ordinary user, keeps evidence locally, and supports one administrator email recipient through operator-controlled SMTP without a QWS account.

The supported platform is Ubuntu 24.04 LTS on amd64 with systemd 255+. Start with the dedicated installation guide. A release archive exposes it as INSTALL.md; after installation it is at /usr/local/share/doc/qwsg/INSTALL.md.

Normal journey

verify archive -> ./bin/qwsg install --check -> sudo ./install.sh
-> qwsg setup -> qwsg readiness

Setup is resumable and guides configuration, optional external notification, and explicit Guardian activation. QWSG never installs packages, invokes sudo, or enables lingering for you. Readiness distinguishes working Guardian core from external notification and requires fresh evidence—not process state alone.

Principal commands

qwsg setup
qwsg setup --plan --format json
qwsg config show
qwsg notification preflight
qwsg notification test
qwsg readiness
qwsg observe
qwsg console

Automation retains qwsg setup --accept-defaults, qwsg setup --set KEY=VALUE, and qwsg config ....

Documentation

• Installation, activation, reboot and uninstall
• Quick Start
• Setup
• Operations
• Troubleshooting
• Security and privacy
• CLI guide

Run qwsg help for the command reference. Developer and architecture material lives under docs/development/ and docs/architecture/ rather than dominating this operator entrypoint. QWSG uses the source-available QWS Community / Free License Version 1.0; see LICENSE.