Management Console configuration file in detail – Resilio Connect

Locate the MC Configuration File

Configuration file “resilio-connect-server.conf” is stored in different locations depending on OS:

Windows (starting from 2.5 version):

C:\ProgramData\Resilio\Connect Server\resilio-connect-server.conf

Linux:

${resilio_connect_server_dir}/var/resilio-connect-server.conf

Notes

It is in JSON format, so please stick to JSON syntax to ensure Resilio Connect Management Console can parse the file successfully. Every time you change the file you’ll need to restart the Connect Management Console for changes to take effect.

Sections & Parameters in the Config File

"loggers" section

Keeps settings for different log files rotation

Field	Default value	Purpose
`maxsize`	`104857600`	In bytes. When a log file reaches this size, it's archived.
`maxFiles`	`10`	Number of archived log files that Console keeps. Older ones are deleted for good.
`tailable`	`true`	New events are added to 'filename' in descending order.

“events_server” section

Event logger logs all the file operations performed by Agents on all clients.

Field	Default value	Purpose
`maxFiles`	`40`	Maximum amount of files stored by event logger
`protocol`	`https`	Protocol used by clients to connect to event server
`maxsize`	`104857600`	Maximum file size. When exceeded, event logger will create a new file, up to maxFiles
`filename`	`/data/events.log`	Name of currently used log
`host`	`0.0.0.0` or `::`	Interface used by event logger for incoming connections. 0.0.0.0 and :: means logger is listening on all available interfaces for IPv4 and IPv6 accordingly
`port`	`8445`	Port used by event logger for incoming connections
from 2.5 `filename`	`history.log`	File name, where event logs are stored. Could be removed if not used

“peerServer” section

peerServer section contains settings used by clients to connect, report status and receive a new set of settings from the Connect Management Console.

Field	Default value	Purpose
`tls`	`{"cert": "certs/peer.crt","key": "certs/peer.key"}` (not present by default)	Path to Management Console certificate and private key, used for establishing SSL connection. Read more on using custom certificate and key here.
`host`	`0.0.0.0` or `::`	Interface used by Connect Management Console for incoming connections. 0.0.0.0 and :: means Console is listening on all available interfaces for IPv4 and IPv6 accordingly
`port`	`8444`	Port used by Connect Management Console for incoming connections

“https” section

https section contains settings used by admin to connect to the Connect Management Console WebUI.

Field	Default value	Purpose
`ssl`	`{"cert": "path/to/web.crt",` `"key": "path/to/web.key"},` (not present by default)	Path to Management Console certificate and private key, used for accessing WebUI over SSL. Read more on using custom certificate and key here.
`host`	`0.0.0.0` or `::`	Interface used by WebUI for incoming connections. 0.0.0.0 and :: means Management Console is listening on all available interfaces for IPv4 and IPv6 accordingly
`port`	`8443`	Port used by WebUI for incoming connections

“backup” section

backup section contains settings on backing up all Resilio Console data as well as cleanup schedule.

Field	Default value	Purpose
`ttl`	`30`	Time in days for storing backups
`cleanup`	`0 0 6 * * *`	Schedule to clean up old backups
`schedule`	`0 0 6 * * *`	Schedule to perform backups
`"path"`	`"data/server_backup"`	Backups location

The "0 0 6 * * *" is a way to schedule a task very similar to the one in crontab with the only difference that values are "second, minute, hour, day of month, month, day of week". So the "0 0 6 * * *" indicates to make a daily backup at 6am.

“reporting” section

Field	Default value	Purpose
`dir`	data/reporting/daily	Name of the directory where event databases are stored
`ttl`	`1209600000` (N_Days_a_Year * Miliseconds_a_Day)	Number in milliseconds for how long event databases are stored. Put this parameter on next level below "reporting".

"usersSecurity" section

visible in config for clean installation of v2.11. can be added manually to config for updated Management Console

passwordExpirationDaysPeriod	120	Sets the expiration of user's password, in days.
numPreviousPaswordsChecks	10	number of previously used passwords that will be saved and checked to ensure unique password policy. Read more about passwords here.

Other sections and section-less params

winston section is used for Connect Management Console and database logs. It is advised not to change default values.
logs-storage value contains relative path to the store debug logs, collected by Management Console from Agents.
db section contains path to the Connect Management Console database.
system section contains path to file, where Connect Management Console records its PID when started.
agentWorkers - allows to add workers to the main MC process for heavily loaded system. Read here for more details.

Articles in this section