Version: 1.41.0

Sofie Core: System Configuration

Sofie Core is configured at it's most basic level using a settings file and environment variables.

Setting	Use	Default value	Example
`METEOR_SETTINGS`	Contents of settings file (see below)		`$(cat settings.json)`
`NTP_SERVERS`	List of time servers to sync the system to (comma separated).	0.pool.ntp.org, 1.pool.ntp.org, 2.pool.ntp.org
`TZ`	The default time zone of the server (used in logging)		`Europe/Amsterdam`
`MAIL_URL`	Email server to use. See https://docs.meteor.com/api/email.html		`smtps://USERNAME:PASSWORD@HOST:PORT`
`LOG_TO_FILE`	File path to log to file		`/logs/core/`

The settings file is an optional JSON file that contains some configuration settings for how the Sofie Core works and behaves.

To use a settings file:

The structure of the file allows for public and private fields. At the moment, Sofie only uses public fields. Below is an example settings file:

{
    "public": {
        "frameRate": 25
    }
}

There are various settings you can set for an installation. See the list below:

Field name	Use	Default value
`frameRate`	The framerate used to display time-codes in the GUI	`25`
`defaultToCollapsedSegments`	Should all segments be collapsed by default, until the user expands them	`false`
`autoRewindLeavingSegment`	Should segments be automatically rewound after they stop playing	`false`
`autoExpandCurrentNextSegment`	Should the segments be expanded when they are On Air or Next, useful with `defaultToCollapsedSegments`	`false`
`disableBlurBorder`	Should a border be displayed around the Rundown View when it's not in focus and studio mode is enabled	`false`
`defaultTimeScale`	An arbitrary number, defining the default zoom factor of the Timelines	`1`
`allowGrabbingTimeline`	Can Segment Timelines be grabbed to scroll them?	`true`
`enableUserAccounts`	Enables User Accounts and Authentication. If disabled, all user stations will be treated as a single, anonymous user	`false`
`allowUnsyncedSegments`	Switches behavior between unsyncing entire Rundowns or just Segments	`false`
`allowRundownResetOnAir`	Should the user be allowed to reset Rundowns when they are On Air	`false`
`defaultDisplayDuration`	The fallback duration of a Part, when it's expectedDuration is 0. __In milliseconds	`3000`

The exact definition for the settings can be found in the code here.