WebMail Lite Documentation

Modules settings reference

Various features and functionality aspects of WebMail Lite are provided by different modules. Each module has its configuration file under data/settings/modules/ directory.

AdminAuth

Disabled
Setting to true disables the module
SuperadminWhitelistIp
If non-empty, only listed IPs are allowed access from
AllowLoginFromCoreModule
If set to true, superadmin account is allowed to log into main login page

AdminPanelWebclient

Disabled
Setting to true disables the module
EntitiesPerPage
Number of items (users, domains etc.) shown per page in admin interface
TabsOrder
Defines list of adminpanel interface sections and the order of displaying those
EntitiesOrder
Defines list of top menu entries and the order of displaying those

ChangePasswordWebclient

Disabled
Setting to true disables the module
ShowSingleMailChangePasswordInCommonSettings
If set to true, Change Password button is displayed in Common settings rather than under Email Accounts section
ShowSingleMailChangePasswordInSecuritySettings
If set to true, Change Password button is displayed in Security settings, SecuritySettingsWebclient module

Contacts

Disabled
Setting to true disables the module
ContactsPerPage
Number of contacts displayer ped page
ImportContactsLink
URL of documentation page that explains structure of CSV files used
AllowAddressBooksManagement
Setting to true enables managing multiple address books
AllowEditTeamContactsByTenantAdmins
Setting to true allows tenant admin to edit Team address book entries

ContactsWebclient

Disabled
Setting to true disables the module
AvailableFor
Automatically provide this feature if one of the listed modules is requested by the entry point

Core

Disabled
Setting to true disables the module
AllowCapa
If set to true, product features can be enabled/disabled on user or tenant level
AllowPostLogin
If set to true, credentials can be submitted via POST request
CsrfTokenProtection
If set to true, CSRF protection is enabled
CronTimeToRunSeconds
Defines intervals in seconds to run a routine of deleting temporary files
CronTimeToKillSeconds
Defines minimal age in seconds of temporary files to be deleted
CronTimeFile
Defines filename for storing last timestamp when routine of deleting temporary files was run
UserSelectsDateFormat
If set to true, users can select date format
DateFormat
Defines default date format used
DateFormatList
Defines default date format used
GetAccountWithPassword
LanguageListComment
LanguageList
Empty array means that every language from every module will be available. ["English", "German"] means that only English and German languages will be used in the system.
Language
Default interface language used
AutodetectLanguage
Setting to true enables language autodetection
PostLoginErrorRedirectUrl
If login credentials were supplied with POST method, this setting defines redirect URL used when authentication error occurs
TimeFormat
Denotes time format used by default
SiteName
Text used in browser title as a website name
ProductName
Product name, displayed in About tab of adminpanel
AuthTokenCookieExpireTime
Expiration time for authentication cookie, in days
EnableFailedLoginBlock
Setting to true enables feature of blocking user after a number of failed login attempts
LoginBlockAvailableTriesCount
Number of failed login attempts which will result in blocking user
LoginBlockDurationMinutes
Number of minutes user will be blocked for upon multiple failed login attempts
AllowGroups
Setting to true enables user groups which can be managed in adminpanel

CoreWebclient

Disabled
Setting to true disables the module
AllowChangeSettings
If true, users are allowed to select theme, language etc. in common settings screen
AllowClientDebug
Enables clientside debug logs, viewed by entering window.auroraLogs in browser console
AllowDesktopNotifications
Enables desktop notifications, the value is applied to new user accounts
AllowIosProfile
Enables retrieving account profile download when logging into web interface from iOS device
AllowMobile
Enables mobile version of web interface and automatically switches to it on Android or iOS smartphone
AllowPrefetch
Enables downloading message bodies in background, to display messages instantly upon selecting those
AttachmentSizeLimit
Attachment file size limit for upload, in bytes
AutoRefreshIntervalMinutes
Default value for auto refresh interval in minutes
ContentSecurityPolicy
Specifies CSP header used for protection from cross-site scripting, clickjacking, code injection attacks
CustomLogoutUrl
Specifies URL user will be redirected to upon logging out of their account
DefaultAnonymScreenHash
Hash ID of the screen available to non-logged in user by default
DefaultUserScreenHash
Hash ID of the screen available to logged in user by default
GoogleAnalyticsAccount
If specified, Google Analytics code will be loaded with this account ID used
HeaderModulesOrder
Denotes the list of top menu items in the order how they're displayed
IsDemo
Enables warnings of demo limitations, used by various modules
LanguageNames
Mapping of language names and their local translations
MultipleFilesUploadLimit
Defines a limit for number of files uploaded during a single user request
ShowQuotaBar
If true, indicator of disk space usage by email or files will be displayed in the interface
ShowQuotaBarTextAsTooltip
If true, quota information will only be shown as the tooltip of the indicator; if false, it's shown directly in the interface
QuotaWarningPerc
Enables warning if percentage of free disk space for email account is less than this value
SyncIosAfterLogin
Theme
Theme used by default
ThemeList
List of themes available
HideLogout
If true, Logout link will be hidden
IncludeInMobile
If true, the module is used in mobile version of the interface

CpanelIntegrator

Disabled
Setting to true disables the module
CpanelHost
Hostname of cPanel server the integration is configured for
CpanelPort
Port number used to connect to cPanel server
CpanelUser
User account used for integration with cPanel server
CpanelPassword
Password of the account used for integration with cPanel server
UserDefaultQuotaMB
Default quota of new email accounts created on cPanel
SupportedServers
List of mail servers the integration applies to, * for all the mail servers
AllowCreateDeleteAccountOnCpanel
Enables managing email accounts from within adminpanel interface of our product
AllowAliases
Enables creating mail aliases from our adminpanel
ForwardScriptPath

Dropbox

Disabled
Setting to true disables the module
EnableModule
Setting to true allows for using and configuring the module
Id
App ID (App key) obtained from Dropbox app
Secret
App secret obtained from Dropbox app

DropboxAuthWebclient

Disabled
Scopes

EavObjectViewer

Disabled

Facebook

Disabled
Setting to true disables the module
EnableModule
Setting to true allows for using and configuring the module
Id
App ID obtained from Facebook Developer console
Secret
App Secret obtained from Facebook Developer console

FacebookAuthWebclient

Disabled
Scopes

Google

Disabled
Setting to true disables the module
EnableModule
Setting to true allows for using and configuring the module
Id
App ID obtained from Google app settings
Secret
App secret obtained from Google app settings
Key
API key obtained from Google app settings

GoogleAuthWebclient

Disabled
Scopes

ImportExportMailPlugin

Disabled
Setting to true disables the module
UploadSizeLimitMb
Defines upload file size limit, in Mbytes

LogsViewerWebclient

Disabled
Setting to true disables the module
AppName
AuthMode
TokenMode
Url
ViewLastLogSize
Defines size of the log file section to view, in bytes

Mail

Disabled
Setting to true disables the module
AllowAddAccounts
If true, Add New Account button is displayed in Email Accounts area of Settings
AllowAutosaveInDrafts
If true, message being composed is periodically saved to Drafts folder
AllowChangeMailQuotaOnMailServer
If true, allows setting email account quota in admin area
AllowDefaultAccountForUser
If true, a user has a default account and its email adress equals user's PublicId
AllowIdentities
Enables using identities on composing mails and managing them in Settings area
OnlyUserEmailsInIdentities
If true, email address cannot be changed when adding or editing an identity
AllowFilters
Enables Filters tab in account settings
AllowForward
Enables Forward tab in account settings
AllowAutoresponder
Enables Autoresponder tab in account settings
EnableAllowBlockLists
DefaultSpamScore
ConvertSpamScoreToSpamLevel
SieveSpamRuleCondition
AllowInsertImage
Enables toolbar button for inserting an image when editing message text
AlwaysShowImagesInMessage
If true, external images are always displayed when viewing email messages
AutoSaveIntervalSeconds
Defines interval for saving messages to Drafts periodically, in seconds
AllowTemplateFolders
Allows for setting a folder as template one under Manage Folders screen
AllowInsertTemplateOnCompose
If true, a tool for inserting a template is added on message compose screen
MaxTemplatesCountOnCompose
A limit of number of email templates available for selecting on message compose screen
AllowAlwaysRefreshFolders
DisplayInlineCss
If true, CSS of a message will be converted to inline one when displaying message
CleanupOutputBeforeDownload
IgnoreImapSubscription
If true, all the email folders can be accessed, regardless of their IMAP subscription status; also, a tool for hiding/showing folder is removed from Manage Folders screen
ImageUploadSizeLimit
Sets a limit of image file size for upload, or 0 for unlimited
SaveRepliesToCurrFolder
Defines a default behavior for saving replies to the original folder of the message, can be changed in user settings
SieveGeneralPassword
Defines ManageSieve access password if it's required by the agent
SieveFileName
Defines default filename of Sieve rules file
SieveFiltersFolderCharset
Defines charset used in Sieve rules files
OverriddenSieveHost
If set, this value will be used as ManageSieve host - by default, IMAP host value is used for this
SievePort
Defines port number for accessing ManageSieve agent
UseBodyStructuresForHasAttachmentsSearch
If true, attempts to use IMAP bodystructure to perform search for messages that have attachments
UseDateFromHeaders
If true, date and time information for displaying a message is obtained from message headers, not from IMAP envelopes
XMailerValue
If set, defines a value for X-Mailer header added to messages sent out
ForwardedFlagName
Defines a flag used to show message as Forwarded one
PreferStarttls
If true, STARTTLS will automatically be used if mail server advertises its support
ExternalHostNameOfLocalImap
Default external hostname for IMAP server, used by autodiscover
ExternalHostNameOfLocalSmtp
Default external hostname for SMTP server, used by autodiscover
AutocreateMailAccountOnNewUserFirstLogin
If true, a new account will be created in the database on first successful login
SieveUseStarttls
If true, STARTTLS will automatically be used to communicate to Sieve server
DisableStarttlsForLocalhost
If true, STARTTLS will not be used for a local mailserver
XOriginatingIPHeaderName
If set, defines a name of header included into outgoing mail, header's value is IP address of the sender
DoImapLoginOnAccountCreate
If true, logging onto IMAP will be performed when adding a new account in adminpanel
MessagesSortBy
Defines a set of rules for sorting mail
CreateHtmlLinksFromTextLinksInDOM
SieveCheckScript
If set, CHECKSCRIPT will be run prior to applying Sieve file changes
MessagesInfoChunkSize
ExpiredLinkLifetimeMinutes
AllowUnifiedInbox
Enables Unified Inbox feature
UseIdentityEmailAsSmtpMailFrom
If true, email address of the identity will be used in MAIL FROM command to SMTP server, instead of main email address of the account

MailAuthCpanel

Disabled
Setting to true disables the module

MailChangePasswordPoppassdPlugin

Disabled
Setting to true disables the module
SupportedServers
Defines a list of servers the password change is enabled for, or * for all the servers
Host
Defines hostname used to connect to POPPASSD service
Port
Defines port number used to connect to POPPASSD service

MailLoginFormWebclient

Disabled
Setting to true disables the module
ServerModuleName
Defines name of the module responsible for login page
HashModuleName
Defines hash of the module responsible for login page
CustomLoginUrl
DemoLogin
If set, denotes email address of predefined demo account
DemoPassword
If set, denotes password of predefined demo account
InfoText
Defines additional text message shown on login page
BottomInfoHtmlText
Defines bottom text message shown on login page
LoginSignMeType
AllowChangeLanguage
Enables changing language on login page
UseDropdownLanguagesView
If true, language selector is presented as a dropdown menu

MailMasterPassword

Disabled
Setting to true disables the module
Password
Hash value of master password supplied in admin interface

MailNotesPlugin

Disabled
Setting to true disables the module

MailSaveMessageAsPdfPlugin

Disabled
Setting to true disables the module
IncludeInMobile
If true, the module is used in mobile version of the interface

MailSensitivityWebclientPlugin

Disabled
Setting to true disables the module
AvailableFor
Automatically provide this feature if one of the listed modules is requested by the entry point

MailTnefWebclientPlugin

Disabled
Setting to true disables the module
IncludeInMobile
If true, the module is used in mobile version of the interface

MailWebclient

Disabled
Setting to true disables the module
AllowAppRegisterMailto
Enables setting the product installation as mailto: links handler
AllowChangeInputDirection
Enables switching between RTL and LTR input directions
FoldersExpandedByDefault
If true, email folders hierarchy is displayed fully expanded by default, collapsed otherwise
AllowSpamFolder
Enables the use of Spam folder and moving messages from/to Spam with a button
AllowAddNewFolderOnMainScreen
If true, New Folder button is added on mail screen
ComposeToolbarOrder
Defines list of controls shown on compose toolbar in their order from left to right
DefaultFontName
Font name used by default when composing email message
DefaultFontSize
Font size used by default when composing email message
AlwaysTryUseImageWhilePasting
If true, complex content like tables will be pasted as image by default
AllowHorizontalLineButton
If true, Insert Horizontal Line button is added to compose toolbar
JoinReplyPrefixes
If true, multiple prefixes such as Re: or Fwd: will be merged as much as possible when composing a new reply/forward
MailsPerPage
Default number of mail messages displayed per page
MaxMessagesBodiesSizeToPrefetch
Sets a limit of message bodies to be prefetched, in bytes
MessageBodyTruncationThreshold
ShowEmailAsTabName
If true, email address will be shown instead of Mail screen tab name
AllowOtherModulesToReplaceTabsbarHeader
AllowShowMessagesCountInFolderList
If true, number of messages will be displayed for all folders in the list
AllowSearchMessagesBySubject
Enables the feature of searching for text selection in Subject area of preview pane
PrefixesToRemoveBeforeSearchMessagesBySubject
AllowHorizontalLayout
If true, users are able to switch betwee vertical and horizontal layouts of mail screen
HorizontalLayoutByDefault
If true, horizontal layout is used on mail screen by default
DisableRtlRendering
AllowQuickReply
If true, a quick reply pane is available under message preview
AllowQuickSendOnCompose
Enables Ctrl-Enter shortcut for sending mail out
AllowUserGroupsInComposeAutocomplete
If true, user groups become available in address autocompletion when composing a message
MarkMessageSeenWhenViewing
If true, message automatically becomes read when viewed by selecting it in message list
MarkMessageSeenWhenAnswerForward
If true, message becomes read when forwarded or replied to
UserLoginPartInAccountDropdown
UseMeRecipientForMessages
If true, 'me' will be displayed insted of user's email address in headers section of message preview pane (collapsed view only)

MailZipWebclientPlugin

Disabled
Setting to true disables the module
ExpandZipFilesLimit
Sets a limit for number of files shown when expanding ZIP archive
IncludeInMobile
If true, the module is used in mobile version of the interface

Min

Disabled
Setting to true disables the module

OAuthIntegratorWebclient

Disabled
AuthModuleName
OnlyPasswordForAccountCreate
AllowNewUsersRegister

OfficeDocumentViewer

Disabled
Setting to true disables the module
IncludeInMobile
If true, the module is used in mobile version of the interface
ExtensionsToView
Defines a list of file types which can be viewed by external web service
ViewerUrl
URL of external web service used for viewing files

OpenPgpWebclient

Disabled
Setting to true disables the module
AvailableFor
Automatically provide this feature if one of the listed modules is requested by the entry point

OverrideUserSettings

Disabled
Setting to true disables the module
Domains
Defines a list of domains, with a list of features disabled for each of those domains

PersonalContacts

Disabled
Setting to true disables the module

RecaptchaWebclientPlugin

Disabled
Setting to true disables the module
PublicKey
Public key obtained at reCAPTCHA website
PrivateKey
Private key obtained at reCAPTCHA website
LimitCount
Denotes number of unsuccessful login attempts required for CAPTCHA to be displayed, 0 - always displayed
WhitelistIPs
List of IP addresses CAPTCHA is never be displayed for
IncludeInMobile
If true, the module is used in mobile version of the interface
IncludeInDesktop
If true, the module is used in desktop version of the interface
RequestMethod
Request method used by API

SessionTimeoutWebclient

Disabled
Setting to true disables the module
TimeoutMinutes
Time interval of inactivity the users are logged after
IncludeInMobile
If true, the module is used in mobile version of the interface

SettingsWebclient

Disabled
Setting to true disables the module
TabsOrder
Defines list of tabs and the order they're displayed in

StandardLoginFormWebclient

Disabled
Setting to true disables the module
ServerModuleName
Defines name of the module responsible for login page
HashModuleName
Defines hash of the module responsible for login page
CustomLoginUrl
DemoLogin
If set, denotes email address of predefined demo account
DemoPassword
If set, denotes password of predefined demo account
InfoText
Defines additional text message shown on login page
BottomInfoHtmlText
Defines bottom text message shown on login page
LoginSignMeType
AllowChangeLanguage
Enables changing language on login page
UseDropdownLanguagesView
If true, language selector is presented as a dropdown menu
AuthTokenCookieExpireTime
Sets authentication token expiry time, in days

TwoFactorAuth

Disabled
Setting to true disables the module
ShowRecommendationToConfigure
If true, users will get a message suggesting to enable 2FA if it's not enabled in their accounts yet
AllowSecurityKeys
Enables support for security keys
FacetIds
List of app-key-hashes of mobile apps
AllowAuthenticatorApp
Enables use of authenticator app
ClockTolerance
Value set to N means that codes starting from N * 30sec ago to N * 30sec from now are accepted
AllowBackupCodes
If set to true, and if authenticator app or security key configured, users are able to use backup codes
AllowUsedDevices
Enables managing trusted devices
TrustDevicesForDays
Allows for expiry of trusted device list entries after certain amount of days
IncludeInMobile
If true, the module is used in mobile version of the interface
IncludeInDesktop
If true, the module is used in desktop version of the interface
RequireInMobile
List of other modules required by this module