Bragi Docs Help

Settings

The Settings page lets you manage behind-the-scenes configuration for Bragi. Some settings apply globally, while others can be tailored per Environment.

The first half of the settings page populated with default values
The second half of the settings page populated with default values

Field

Description

Version

The current version of Bragi. This is read-only and cannot be modified.

Scheduler API URL (Environment)

The API URL used by the Scheduler for this Environment.

Scheduler TimeSpan (Environment)

Specifies how often the Scheduler "ticks" to check for work. Format is HH:MM:SS (e.g., 00:00:10 means every 10 seconds). This value is also the default and the minimum allowed.

Display Finished Items On Scheduler TimeSpan (Environment)

Duration that finished items remain visible on the Scheduler page. Format is HH:MM:SS (e.g., 00:00:30 means 30 seconds). This is the default setting.

History Days

Number of days to retain historic WebApp logs, Scheduler logs, and Scheduler history. Defaults to 30 days. These logs are cleared periodically by the WebApp.

SQL Bulk Insert Path (Environment)

If enabled, Bragi uses BULK INSERT for Loads instead of in-memory writes to SQL Server. This significantly boosts performance for large Loads. Both Scheduler and SQL Server must have access to this folder.

SQL Bulk Insert Keep Failed DAT files (Environment)

When SQL Bulk Insert Path is enabled, this option keeps the .dat file used during the load process if the load fails. Useful for debugging, but it’s recommended to disable this after troubleshooting to conserve storage.

Daily Summary Emails (Environment)

Controls daily summary email settings for this Environment:

Time For Daily Summary Email (Environment)

The local time to send the Daily Summary email, format HH:MM. Default is 23:00 (11 PM).

Recipients for the Daily Summary Email (Environment)

Semicolon-separated list of email addresses to receive the daily summary.

Daily Summary Last Sent (Environment)

Timestamp recording when the last Daily Summary email was sent. This field is read-only.

Recipients for the Job Failed Email (Environment)

Semicolon-separated list of email addresses that should receive notifications when a Job fails.

Environment Base Colour

Custom colour to visually distinguish this Bragi Environment in the UI.

SQL Timeout (Environment)

Timeout period in minutes for SQL operations. Default is 10 minutes.

Scheduler Async Tasks Count (Environment)

Number of Jobs the Scheduler can run concurrently. Setting depends on whether you want asynchronous or synchronous operation and the available server resources. Default is 1.

Scheduler First Run Delay (Environment)

Number of seconds the Scheduler waits before running tasks after starting up the scheduler. Default is 10.

Emails

Email-related configuration options:

-Passthrough Authentication

If the Service Account running Bragi has access to the Email Server without needing username/password credentials, enabling this bypasses the username/password prompts.

-Ignore Server Certificate Validation

Use this if your email server does not have properly configured certificates, to bypass certificate validation errors when sending emails.

This page is where you fine-tune Bragi’s core behaviour to match your operational and infrastructure needs.

09 March 2026