ReferenceReferenceConfiguration

Configuration

Settings

bash
memnox config list
memnox config get mode
memnox config set mode enforce
SettingValuesDefault
modeoff, observe, advise, enforceobserve on a new machine
retentionDaysdays of history kept, see memnox purge30
failOpenlet a call through when Memnox cannot answerfalse
telemetrysend counts only, never contentsfalse
approvedAgentsagents you allow here, others are reportedempty
noticeUnusualask about an action this agent has never takentrue
noticeWarmupDaysdays after setup when a first action is only recorded3

Environment variables

VariableWhat it does
MEMNOX_POLICIESWhich rule file to load first
MEMNOX_SESSIONThe session an action belongs to. memnox run sets it.
MEMNOX_AGENT_NAMEThe agent name rules match against
MEMNOX_HOMEWhere ~/.memnox lives

For an agent started by systemd, Docker or cron, print what it needs:

bash
memnox env --format systemd
memnox env --format docker

Files

PathWhat it is
memnox.policies.tomlYour repository's rules
~/.memnox/machine.policies.tomlRules for every repository on this machine
~/.memnox/config.tomlThe settings above
~/.memnox/memnox.dbThe decision log
~/.memnox/bin/The shell wrappers
~/.memnox/backup/Agent configs as they were before setup

Which file wins

A file named on the command line beats MEMNOX_POLICIES, which beats the file in the current folder. Inside the rules, the strictest answer wins, not the first one in the file.