mongoui

Workflows

Deployment drift CLI

Run credential-free Mongoui deployment policies in CI without installing Node.js.

The mongoui-drift executable runs a saved Environment Compare → Deployment policy against two MongoDB deployments. It is local-first: the executable connects directly to both deployments, and the report contains bounded structural evidence rather than connection strings, credentials, documents, validators, or commands.

Export a policy

In the desktop app, save a deployment review profile, choose an explicit known-good baseline, and export the policy. Commit that policy JSON with the service or infrastructure it protects.

Run the gate

Download the native archive for your platform from the current release metadata, extract it, then provide both connection strings through environment variables:

MONGOUI_SOURCE_URI='mongodb://source.example/...' \
MONGOUI_DESTINATION_URI='mongodb://destination.example/...' \
./mongoui-drift \
  --policy mongoui-production.policy.json \
  --report mongoui-drift-report.json

The executable includes its runtime. Node.js, npm, tsx, and a Mongoui source checkout are not required.

Exit code 0 means the evidence is stable or only contains resolved drift. Exit code 1 means new or changed drift or incomplete coverage. Exit code 2 means the policy, arguments, connection, or runtime failed.

Update a baseline

Replace the policy baseline only after reviewing a complete known-good comparison:

MONGOUI_SOURCE_URI='mongodb://source.example/...' \
MONGOUI_DESTINATION_URI='mongodb://destination.example/...' \
./mongoui-drift --policy mongoui-production.policy.json --update

The update is explicit and writes only the same bounded structural baseline used by the desktop workflow.

Verify the download

Each archive's SHA-256, platform, architecture, and signing status are published in version.json. macOS executables are Developer ID signed and their archives are notarized. Windows and Linux archives are currently unsigned, so verify their SHA-256 before running them.