The settings page allows to do a system-wide configuration. There're several sections on the page.


You can change current user name (!not login) and password.

User settings

Each user can define individually, what types of notifications he wants to receive. A Notification is a message that that come either from manager, or from heads.

  • DB status: A notification comes, if system detects an issue related to the System DB.
  • Events: General events notifications.
  • Pipelines status: Messages from Heads with information that pipeline starts, stops or has an issue.
  • Servers status: Messages from Heads with information that head starts, stops or has an issue.
  • User notifications: A user can set up an output of type 'Notifications' to make the system send messages, if certain events occurs. Here every user can tell the system, if he wants to receive these event-related notifications.

User management

There’re two types of users in BitRefine Heads: administrators and regular users. The difference is that regular user can’t modify configuration of heads' processing pipelines and can't add or remove other users.

New users are added only by administrators. In the section All users click on 'Add new user' button, enter a name (login), a password and new user’s role. After saving the new user will be able to change his password from the section Current user.

User management


It is recommended to make a complete backup of systems configuration from time to time. To do this click on Save button in the Backup section. To restore configuration click Restore and choose the configuration file from disk.

User settings

There are two types of logs: the manager's log and the heads' individual logs. All general events are recorded in the log file, maintained by manager. You can save it as a text file from Logs section. Each head does its own logging. This log contains much more details about the head. You can access each head's individual log from server settings. This log is available even after the head has stopped, but when the head starts again, system overwrites the previous session's log.


The section modules shows full list of the processors, models and outputs, available in this project.

Modules settings

If you've got an extra module, you can upload it using Upload .zip button. After the upload completed you'll see this new module in the list and also will be able to add it to your pipelines.


Misc settings

  • Archive storage time: System DB entries older than this value will be automatically deleted. Zero means no restriction. This is global DB parameter. (Reference images may be overwritten even earlier. It depends of the size of the System DB storage file.)
  • Pipeline video resolution: The resolution of videostream that HEADs send to the users. Use lower resolution, if network connection is limited or in case of insufficient HEAD's compute capability.
  • Log level: Set log level for the manager and the heads.