[main] section

The [main] section contains the high-level program options for dupReport to run properly.

version=<major>.<minor>.<subminor>

The current version number of the program. Used to determine if the .rc file needs to be updated. PLEASE DO NOT alter the version= option

dbpath=<dbpath>

Directory where the dupReport.db file is located. Can be overridden by the -d command line option.

logpath=<logpath> 

The directory where the dupReport.log file is located. Can be overridden by the -l command line option.

verbose=

• 0=No log output
• 1=(Default) General program execution info.
• 2=Program flow and status information
• 3=Full debugging output

Sets the level of detail the program will put in the log file. Can be overridden by the -v command line option.

logappend=false

Append new logs to the log file (true) or reset log file for each run (false). Can be overridden by the -a command line option.

subjectregex=^Duplicati Backup report for

A regular expression used to find backup message Emails Of Interest. This should somewhat match the text specified in the ‘send-mail-subject’ advanced option in Duplicati.

NOTE: If you modify the subject line of your Duplicati emails by changing the ‘send-mail-subject’ option, make sure that the subject line you construct does not use the character you specify as the Source/Destination delimiter in the srcdestdelimiter= option in dupReport.rc (see below). If the subject line uses the same character as the Source/Destination delimiter, dupReport will get confused and not parse your emails properly.

srcregex=\w*

Regular expression used to find the “source” side of the source-destination pair in the subject line of the email.

destregex=\w*

Regular expression used to find the “destination” side of the source-destination pair in the subject line of the email.

srcdestdelimiter=-

Single character used to specify the delimiter between the ‘source’ and ‘destination’ parts of the source-destination pair.

dateformat=MM/DD/YYYY

Default format for dates found in emails. Acceptable formats are:

• MM/DD/YYYY
• DD/MM/YYYY
• MM-DD-YYYY
• DD-MM-YYYY
• MM.DD.YYYY
• DD.MM.YYYY
• YYYY/MM/DD
• YYYY/DD/MM
• YYYY-MM-DD
• YYYY-DD-MM
• YYYY.MM.DD
• YYYY.DD.MM

If there are problems in your report dates (especially if your locale doesn't use U.S.-style dates), or if you are getting program crashes around the date/time routines, you might try checking and/or changing this value.

The default format can be overridden for specific backup jobs by specifying a dateformat= line in a job-specific section of the .rc file. See “[source-destination] Sections” below.

timeformat=HH:MM:SS

Default format for times found in emails. The only time format currently acceptable is ‘HH:MM:SS’. The default format can be overridden for specific backup jobs by specifying a timeformat= line in a job-specific section of the .rc file. See “[source-destination] Sections” below.

warnoncollect=false

If true, send an email if there are warning or error messages in incoming email. Only works if the -c option is specified so the user will get error messages even if they are not producing an email report.

applyutcoffset=true

Duplicati version 2 does not apply local time zone information when reporting start and end times for backup jobs. If set to 'true', this option takes the UTC time zone offset from the email header and applies it to the backup job start and end times. If the backup times in your report do not look right, try adjusting this value.

show24hourtime=false

If true, times will be displayed in 24-hour notation. Otherwise, dupReport will use 12-hour, AM/PM notation.

purgedb=true

If true, emails in the database that are no longer found on the incoming email server will be purged from the database and the database will be compacted. NOTE: Any source-destination pairs referenced in purged emails will remain in the database in case emails for those pairs are seen in the future. To remove obsolete source-destination pairs from the database, use the -m option.

showprogress=0

If this option is greater than zero, dupReport will display a dot ('.') on stdout for every 'n' emails that are processed from the incoming server. For example, if showprogress=5, there will be one '.' for every 5 emails that are read.

masksensitive = true

Masks sensitive data in the log file. If set to "true" (the default), fields such as user name, password, server name, and file paths will be masked with asterisks in the log file. This is useful for maintaining privacy if the log file needs to be stored or transmitted somewhere else for debugging or analysis purposes. NOTE: this setting will not mask any information found in the actual emails pulled from your email server, such as sending and receiving email address, server names, etc. It only affects the data that dupReport generates as part of its operation.

markread = false

When set to "true" dupReport will instruct the email server to mark all emails as read/seen once they have been processed by the program. The default is "false" allowing the program to leave the email inbox in the same state as it found it. NOTE: this option is only available when using the IMAP protocol. POP3 does not have this capability.