Currently homenet is only used for Suricata, but could be used for other tools in the future.


A node can be assigned either the global homenet or its own homenet.

By default, a node will use the global homenet pillar value if it is defind in the global pillar file (/opt/so/saltstack/local/pillar/global.sls) under global:hnmanager.

  soversion: '2.3.0'
  hnmanager: ',,'

In order to define a per node homenet, it can be defined in the minion pillar file (/opt/so/saltstack/local/pillar/minions/$SENSORNAME_$ROLE.sls) under sensor:hnsensor.

  interface: 'bond0'
  mainip: ''
  mainint: 'eth0'
  zeek_lbprocs: 5
  suriprocs: 2
  manager: 'somanager1'
  mtu: 1500
  uniqueid: 1602623674

In order to sync the configuration change with the node, we can either wait for the node to automatically highstate on the predefined interval, or we can force it. Since this homenet only applies to Suricata, we can apply the suricata state to the node.

  • From the manager:

    sudo salt $SENSORNAME_$ROLE state.apply suricata


  • From the node:

    sudo salt-call state.apply suricata

More Information

See also

For more information about Suricata, such as defining other address groups or ports groups, please see the Suricata section.