Pulse/docs/operations/SENSOR_PROXY_CONFIG.md
courtmanr@gmail.com fd39196166 refactor: finalize documentation overhaul
- Refactor specialized docs for conciseness and clarity
- Rename files to UPPER_CASE.md convention
- Verify accuracy against codebase
- Fix broken links
2025-11-25 00:45:20 +00:00

986 B

⚙️ Sensor Proxy Configuration

Safe configuration management using the CLI (v4.31.1+).

📂 Files

  • config.yaml: General settings (logging, metrics).
  • allowed_nodes.yaml: Authorized node list (managed via CLI).

🛠️ CLI Reference

Validation

Check for errors before restart.

pulse-sensor-proxy config validate

Managing Nodes

Add Nodes (Merge):

pulse-sensor-proxy config set-allowed-nodes --merge 192.168.0.10

Replace List:

pulse-sensor-proxy config set-allowed-nodes --replace \
  --merge 192.168.0.1 --merge 192.168.0.2

⚠️ Troubleshooting

Validation Fails:

  • Check for duplicate allowed_nodes blocks in config.yaml.
  • Run pulse-sensor-proxy config validate 2>&1 for details.

Lock Errors:

  • Remove stale locks if process is dead: rm /etc/pulse-sensor-proxy/*.lock.

Empty List:

  • Valid for IPC-only clusters.
  • Populate manually if needed using --replace.