Skip to content

The Preferences window

wiki auto updater edited this page Feb 12, 2026 · 3 revisions

Here you can configure the settings of the GUI and the nodes.

Some things to keep in mind:

  • The GUI is a server, which receives connections from remote nodes. That's why there's a section for the UI and the Server.
  • Almost all the labels and widgets have tooltips with explanations of the option.

Pop-ups

Default options of the pop-ups

Captura de pantalla de 2026-02-11 23-58-49999

UI

Options to customize the UI.

Captura de pantalla de 2026-02-12 00-51-26
  • Refresh interval: controls how often the view is refreshed. Default 0. If there're multiple nodes, or a lot of events, a value greater than 0 will help to redouce the CPU usage of the GUI.
  • Theme: The GUI can be customized if you install the package qt-material ($ pip3 install qt-material)

Desktopn notifications

When a pop-up is not answered on time, it'll apply a rule with the default options configured.

It'll also send a notification to the system. Here you can configure the content of that notification:

Captura de pantalla de 2026-02-12 01-10-18

Available fields (use the format %<field>%):

  • conn.time, conn.action, conn.dstip, conn.dsthost, conn.dstport, conn.proto, conn.process, conn.process_args, conn.process_cwd, rule.action, rule.name, node.name, node.hostname

Server

These options controls the server part of the GUI to deal with nodes.

Captura de pantalla de 2026-02-12 00-51-41
  • Max server workers: Each connected node consumes around 2 workers. If there're more nodes than workers, the GUI won't allow new messages from nodes. Increase it if there're more than ~15 nodes connected.
  • Max server clients: Limits the number of nodes that can connect to the GUI. 0 unlimited (default).
  • Keepalive interval (milliseconds): Every n milliseconds, the server (GUI) verifies if the nodes are alived. If it doesn't receive a response from a node in n milliseconds, the Keepalive timeout will start to count.
  • Keepalive timeout (milliseconds): After n milliseconds, the server (GUI) will close the connection with the node that stopped responding. The node if is alived, will try to reconnect.

Nodes

Nodes configuration:

Captura de pantalla de 2026-02-12 00-51-55

When changing the configuration of a node, be sure that you selected correctly the node!

You can also apply the configuration to all nodes.

More information about nodes management: Nodes

Database

Captura de pantalla de 2026-02-12 00-52-03

Clone this wiki locally