Skip to content

Agent Configuration

Configuration File

Location varies by platform:

PlatformPath
Linux/var/lib/slimrmm/.slimrmm_config.json
macOS/var/lib/slimrmm/.slimrmm_config.json
WindowsRegistry: HKLM\SOFTWARE\SlimRMM\Agent

Configuration Options

json
{
  "server": "https://rmm.example.com",
  "uuid": "agent-uuid",
  "mtls_enabled": true,
  "log_level": "info",
  "heartbeat_interval": 30,
  "scan_interval": 1800
}

Options

OptionTypeDefaultDescription
serverstring-Server URL
uuidstring-Agent UUID (auto-generated)
mtls_enabledbooltrueUse mTLS authentication
log_levelstringinfodebug, info, warn, error
heartbeat_intervalint30Seconds between heartbeats
scan_intervalint1800Seconds between inventory scans

Certificate Paths

PlatformCertificateKey
Linux/macOS/var/lib/slimrmm/cert.pem/var/lib/slimrmm/key.pem
Windows%ProgramData%\SlimRMM\certs\cert.pem%ProgramData%\SlimRMM\certs\key.pem

Environment Variables

Override config via environment:

bash
export SLIMRMM_SERVER=https://rmm.example.com
export SLIMRMM_LOG_LEVEL=debug

Command Line Flags

bash
slimrmm-agent --help

Flags:
  --server URL       Server URL
  --debug            Enable debug logging
  --install          Install as service
  --uninstall        Uninstall service
  --version          Show version
  --configure        Configure agent
  --token TOKEN      Enrollment token

Released under the MIT License.