The config files are located at
$XDG_CONFIG_HOME/maestral on Linux (typically
~/Library/Application Support/maestral on macOS. Each
configuration will get its own INI file with the settings documented below.
Changes to the config values may be performed through
maestral config set directly but some will only take effect once you restart
Maestral. Editing the config file by hand is also possible if the sync daemon is not
running, they will be overwritten otherwise.
You must not change the
excluded_items config values manually but rather
use the corresponding CLI commands or GUI options, for instance
maestral move-dir or
maestral excluded add. This is because changes of
these settings require Maestral to perform accompanying actions, e.g., download folders
which have been removed from the excluded list or move the local Dropbox directory.
Those will not be performed if you edit the values directly.
This also holds for the
account_id config value which will be written to the config
file after successfully completing the OAuth flow with Dropbox servers.
[auth] # Unique Dropbox account ID. The account's email # address may change and is therefore not stored here. account_id = dbid:AABP7CC5bpYd8cGHqIColDFrMoc9SdhACA4 # The keychain to use to store user credentials. If "automatic", # will be set automatically from available backends when # completing the OAuth flow. Mus be a fully qualified class name. keyring = keyring.backends.macOS.Keyring [app] # Level for desktop notifications: # 15 = FILECHAANGE # 30 = SYNCISSUE # 40 = ERROR # 100 = NONE notification_level = 15 # Level for log messages: # 10 = DEBUG # 20 = INFO # 30 = WARNING # 40 = ERR0R log_level = 20 # Interval in sec to check for updates update_notification_interval = 604800 # Upload limit in bytes / sec (0.0 = unlimited) bandwidth_limit_up = 0.0 # Download limit in bytes / sec (0.0 = unlimited) bandwidth_limit_down = 0.0 # Max number of parallel downloads max_parallel_uploads = 6 # Max number of parallel downloads max_parallel_downloads = 6 [sync] # The current Dropbox directory path = /Users/UserName/Dropbox (Maestral) # List of excluded files and folders excluded_items = ['/test_folder', '/sub/folder'] # Interval in sec to perform a full reindexing reindex_interval = 604800 # Maximum CPU usage per core max_cpu_percent = 20.0 # Maximum sync event history to keep in seconds keep_history = 604800 # Whether upload sync is enabled upload = True # Whether download sync is enabled download = True