Skip to content

Configuration dtable-events

This is a cheat sheet for the dtable-events configuration file dtable-events.conf. It contains all possible settings that can be configured as well as their default values.

The default values provided here are best-effort (not built automatically). They will be used, if no value is defined at all. It is not necessary the value, that is written in the configuration file on first startup.

In the default values below, a value in the form $XYZ refers to an environment variable.

Configuration changes require a restart

New configuration options will only apply after a restart of SeaTable.

Notes about the configuration file format

The configuration file uses the INI format, which is a simple text-based format for storing configuration data. It consists of sections (denoted by square brackets, e.g., [general]) and key-value pairs.

Comments in the configuration file start with the hash symbol # and extend to the end of the line.

When dealing with special characters like single quotes ', double quotes " or the hash symbol #, it's generally best to enclose the value in double quotes.

dtable-events reads values from dtable_web_settings.py

Note that dtable-events reads dtable_web_settings.py for internal URLS and various key settings. Ensure these configurations are correct.

Other configuration files are not used, if you run dtable-events separately.

The following options are grouped by their sections.

Example configuration

This is a typical configuration file, created automatically on the first startup by SeaTable.

[DATABASE]
type = mysql
host = mariadb
port = 3306
username = root
password = topsecret
db_name = dtable_db

[REDIS]
host = redis
port = 6379

Available configuration options

[DATABASE]

Parameter Description Default
type The database connection type. Use mysql for MySQL and MariaDB (other databases are not yet supported) mysql
host MariaDB server address mariadb
port MariaDB server port 3306
db_name Database name dtable_db
username MariaDB username root
password MariaDB password $DB_ROOT_PASSWD

[REDIS]

Parameter Description Default
host Redis server address redis
port Redis server port 6379
password Redis server password

[EMAIL SENDER]

enabled by default.

SeaTable runs this task every hour to send base email notifications for base updates to the users. It also generates the log file dtable_updates_sender.log.

Parameter Description Default
enabled Enables or disables the email notifications for base updates true

[NOTIFY-SCANNER]

disabled by default.

Notification rules are a feature that allows users to set criteria for a base and receive notifications when these criteria are met. This runs a daily job at midnight to clean up inactive notification rules. Rules that have not been triggered for 180 days or were created but never triggered are marked as invalid.

Parameter Description Default
enabled Enables or disables the notification scanner false

[AUTOMATION]

enabled by default.

In SeaTable, users have the ability to define triggers and actions within an automation rule.
These rules are then automatically executed on a base.

Parameter Description Default
per_minute_trigger_limit To maintain server stability, SeaTable includes a feature that restricts the frequency of automation rule executions 50
per_update_auto_rule_workers Number of worker threads used for processing automation rule events 3

[COMMON-DATASET-SYNCER]

enabled by default.

SeaTable runs every hour this event to check for pending dataset syncs. The job processes datasets that need syncing based on their interval (per_day, per_hour) and validity.

Parameter Description Default
enabled Enables or disables the common dataset syncer true

[EMAIL-SYNCER]

enabled by default.

SeaTable runs this event at the 30th minute of every hour. The job processes email sync tasks defined in a base by the user.

Parameter Description Default
enabled Enables or disables the email syncer true
max_workers Maximum number of worker threads for processing email sync tasks 5

[LDAP_SYNC]

disabled by default.

SeaTable could sync LDAP accounts, if activated. This requires additional settings in dtable_web_settings.py. Please refer to LDAP Authentication.

Parameter Description Default
enabled Enables or disables the ldap sync false
sync_interval Specifies the interval at which the LDAP synchronization process should run, in seconds 3600

[ROWS-COUNTER]

enabled by default.

SeaTable runs this event every 24 hours. It counts and updates the total number of rows of a team.

Parameter Description Default
enabled Enables or disables the rows counter for teams true

[VIRUS SCAN]

disabled by default.

This section configures how files are scanned for viruses:

  • Whether scanning is enabled (enabled)
  • The command used to scan files (scan_command)
  • Return codes indicating infected or clean files (virus_code, nonvirus_code)
  • Limits on file size and extensions to skip (scan_size_limit, scan_skip_ext)
  • Concurrency settings (threads)
Parameter Description Default
enabled Enables or disables virus scanning false
scan_command Command used for virus scanning (e.g., clamscan)
virus_code Return codes indicating a file is infected (e.g. 0)
nonvirus_code Return codes indicating a file is clean (e.g. 1)
scan_interval The interval at which the virus scan runs (in minutes) 60
scan_size_limit Maximum file size to scan (in MB); larger files are skipped 20
scan_skip_ext File extensions to exclude from scanning ['.bmp', '.gif', '.ico', '.png', '.jpg', '.mp3', '.mp4', '.wav', '.avi', '.rmvb', '.mkv']
threads Number of threads for parallel scanning 4