Plugins configuration settings
Available on all plans
Cloud and self-hosted deployments
Access the following configuration settings in the System Console by going to Plugins, or by editing the config.json file as described in the following tables:
Plugin management
Access the following configuration settings in the System Console by going to Plugins > Plugin Management.
Enable plugins
True: Enables plugins on your Mattermost server. Use plugins to integrate with third-party systems, extend functionality, or customize the user interface of your Mattermost server. See documentation to learn more.
False: Disables plugins on your Mattermost server.
This feature’s |
Require plugin signature
True: Require valid plugin signatures before starting managed or unmanaged plugins. Pre-packaged plugins are not subject to plugin signature verification. Plugins installed through the Plugin Marketplace are always subject to plugin signature verification at the time of download.
False: Don’t require valid plugin signatures before starting managed or unmanaged plugins. Pre-packaged plugins are not subject to plugin signature verification. Plugins installed through the Plugin Marketplace are always subject to plugin signature verification at the time of download.
This feature’s |
Automatic prepackaged plugins
True: Any pre-packaged plugins enabled in the configuration will be installed or upgraded automatically. If a newer version is already installed, no changes are made.
False: Pre-packaged plugins aren’t installed or upgraded automatically but may be installed manually from the Plugin Marketplace, even when offline.
This feature’s |
Enable Marketplace
True: Enables Plugin Marketplace on your Mattermost server for all System Admins.
False: Disables Plugin Marketplace on your Mattermost server for all System Admins.
This feature’s |
Enable remote Marketplace
True: The server will attempt to connect to the configured Plugin Marketplace to show the latest plugins. If the connection fails, the Plugin Marketplace shows only pre-packaged and already installed plugins alongside a connection error.
False: The server won’t attempt to connect to a remote marketplace, and will show only pre-packaged and already installed plugins. Use this setting if your server can’t connect to the internet.
This feature’s |
This setting only takes effect when "EnableMarketplace": true.
Note
For the Remote Marketplace to operate, each host running the Mattermost service requires network access to the marketplace service endpoint (hosted at https://api.integrations.mattermost.com, see Marketplace URL ).
Marketplace URL
If the Marketplace is enabled, this setting specifies which URL should be used to query for new Marketplace plugins.
This feature’s |
Installed plugin state
Lists installed plugins on your Mattermost server and whether they are enabled. Pre-packaged plugins are installed by default and can be deactivated, but not removed.
This feature’s |
Agenda
Note
Available only for self-hosted deployments
Access the following configuration settings in the System Console by going to Plugins > Agenda.
Antivirus
Note
Available only for self-hosted deployments
This plugin allows the forwarding of uploaded files to an antivirus scanning application, ClamAV anti-virus software, and prevents the upload from completing if there is a virus detected in the file.
Use this plugin to prevent users from inadvertently spreading malware or viruses via your Mattermost server. See the Mattermost Antivirus Plugin documentation for details.
Access the following configuration settings in the System Console by going to Plugins > Antivirus.
Apps
Available on all plans
Cloud and self-hosted deployments
Enable plugin
True: Enables the Apps plugin on your Mattermost server.
False: Disables the Apps plugin on your Mattermost server.
To create your own Mattermost App, see the Mattermost Apps developer documentation.
Autolink
Available on all plans
self-hosted deployments
This plugin creates regular expression (regexp) patterns that are reformatted into a Markdown link before the message is saved into the database. System Admins can configure this plugin in the config.json file, using the /autolink slash command (when enabled), or through using the System Console. See the Autolink Plugin documentation for details.
Access the following configuration settings in the System Console by going to Plugins > Autolink.
Enable plugin
True: Enables the Autolink plugin on your Mattermost server.
False: Disables the Autolink plugin on your Mattermost server.
Enable administration with /autolink command
True: Enables the ability to configure the Apps plugin using the /autolink slash command.
False: Disables the ability to use the slash command to configure the plugin.
AWS SNS
Available on all plans
self-hosted deployments
This plugin is used to receive alert notifications from Amazon AWS CloudWatch to Mattermost channels via AWS Simple Notification Server (SNS).
Access the following configuration settings in the System Console by going to Plugins > AWS SNS.
Enable plugin
True: Enables the AWS SNS plugin on your Mattermost server.
False: Disables the AWS SNS plugin on your Mattermost server.
Channel to send notifications to
Specify the channel to send notifications to in the format teamname,channelname. For example, for a channel with a URL of https://example.com/myteam/channels/mychannel, set the value to myteam,mychannel. If the specified channel does not exist, the plugin creates the channel for you.
Calls (Beta)
Available on all plans
Cloud and self-hosted deployments
Access the following configuration settings in the System Console by going to Plugins > Calls.
Enable plugin
True: Enables the calls plugin on your Mattermost workspace.
False: Disables the calls plugin on your Mattermost workspace.
RTC server port
Note
Available only for self-hosted deployments
The UDP port the RTC server will listen on. All calls traffic will be served through this port. The Default setting is 8443.
Changing this setting requires a plugin restart to take effect.
Enable on specific channels
Note
Available only for self-hosted deployments
True: Allow Channel Admins to enable or disable calls on specific channels. It also allows participants in DMs/GMs to enable or disable calls.
False: Only System Admins will be able to enable or disable calls on specific channels.
Enable on all channels
Note
Available only for self-hosted deployments
True: Enable calls by default on all channels.
False: Calls have to be explicitly enabled on channels.
Max call participants
Note
Available only for self-hosted deployments
The maximum number of participants that can join a single call. This is an optional field and default is 0 (unlimited). The maximum recommended setting is 200.
ICE host override
Note
Available only for self-hosted deployments
An optional override to the host that gets advertised to clients when connecting to calls. Depending on the network infrastructure (e.g. instance behind a NAT device) it may be necessary to set this field to the client facing external IP in order to let clients connect successfully. When empty or unset, the RTC service will attempt to automatically find the instance’s public IP through STUN.
This is an optional field. Changing this setting requires a plugin restart to take effect.
ICE servers configurations
Note
Available only for self-hosted deployments
A list of ICE servers (STUN/TURN) to be used by the service. Value should be valid JSON.
Default is [{"urls": ["stun:stun.global.calls.mattermost.com:3478"]}]
Example
[
{
"urls":[
"stun:stun.global.calls.mattermost.com:3478"
]
},
{
"urls":[
"turn:turn.example.com:3478"
],
"username":"webrtc",
"credentials":"turnpassword"
}
]
This is an optional field. Changing this setting may require a plugin restart to take effect.
TURN static auth secret
Note
Available only for self-hosted deployments
A static secret used to generate short-lived credentials for TURN servers.
This is an optional field.
TURN credentials expiration
Note
Available only for self-hosted deployments
The expiration, in minutes, of the short-lived credentials generated for TURN servers.
Server side TURN
Note
Available only for self-hosted deployments
True: The RTC server will use the configured TURN candidates for server-initiated connections.
False: TURN will be used only on the client-side.
Changing this setting requires a plugin restart to take effect.
RTCD service URL
Available only on The URL to a running rtcd service instance that will host the calls. When set (non empty) all the calls will be handled by this external service.
This is an optional field. Changing this setting requires a plugin restart to take effect.
Channel export
Available on all plans
Cloud and self-hosted deployments
Access the following configuration settings in the System Console by going to Plugins > Channel Export.
Demo plugin
Available on all plans
self-hosted deployments
Access the following configuration settings in the System Console by going to Plugins > Demo Plugin.
Enable plugin
True: Enables the Demo plugin on your Mattermost workspace.
False: Disables the Demo plugin on your Mattermost workspace.
GIF commands
Available on all plans
self-hosted deployments
Access the following configuration settings in the System Console by going to Plugins > GIF commands.
This plugin is used to post GIFs from Gfycat, Giphy, or Tenor using slash commands.
Enable plugin
True: Enables the GIF commands plugin on your Mattermost server.
False: Disables the GIF commands plugin on your Mattermost server.
Display the GIF as
Display the GIF as an embedded image where the GIF can’t be collapsed, or as a collapsible image preview where the full URL displays.
Note
Link previews must be enabled in order to display GIF link previews. Mattermost deployments restricted to access behind a firewall must open port 443 to both https://api.gfycat.com/v1 and https://gfycat.com/<id> (for all request types) for this feature to work.
GIF provider
Specify the GIF provider as GIPHY, Tenor, or Gfycat.
Note
Selecting GIPHY or Tenor requires an API Key for this feature to work. An API key is not required for Gfycat.
Giphy/Tenor API key
Configure your own API Key when specifying the GIF Provider as GIPHY or Tenor. An API key is not required for Gfycat.
To get your own API key, see the GIPHY Developers Quick Start documentation, or the Tenor Developer documentation for details.
Content rating (GIPHY & Tenor only)
Select an MPAA-style content rating for GIFs from GIPHY or Tenor. Leave this field empty to disable content filtering.
Gfycat display style
Specify the display style for GIFs from Gfycat. See the Gfycat Developer API documentation for details.
GIPHY display style
Specify the display style for GIFs from GIPHY. See the GIPHY Developers Rendition Guide for details.
Tenor display style
Specify the display style for GIFs from Tenor. See the Tenor API documentation for details.
Language
Specify the language used to search GIFs from GIPHY. See the GIPHY Developers Language Support documentation for details.
Mattermost Boards
Available on all plans
Cloud and self-hosted deployments
Mattermost Boards is an open source alternative to Trello, Notion, and Asana that’s integrated from Mattermost v5.36. Boards is a project management tool that helps define, organize, track and manage work across teams, using a familiar kanban board view. See the Mattermost Boards product documentation for details.
Access the following configuration settings in the System Console by going to Plugins > Mattermost Boards.
Mattermost Playbooks
Available on all plans
Cloud and self-hosted deployments
Mattermost Playbooks is an open source, self-hosted collaboration tool for teams. Each playbook represents a recurring outcome or specific goal that your teams collaborate on to achieve, such as service outage recovery or customer onboarding. Teams run a playbook every time they want to orchestrate people, tools, and data to achieve that outcome as quickly as possible while providing visibility to stakeholders. Playbooks also allow teams to incorporate learnings from the retrospective to tweak and improve the playbook with every iteration. See the Mattermost Playbooks documentation for details.
Access the following configuration settings in the System Console by going to Plugins > Playbooks.
User satisfaction surveys
Available on all plans
Cloud and self-hosted deployments
This plugin enables Mattermost to send user satisfaction surveys to gather feedback and improve product quality directly from your Mattermost users. Please refer to the Mattermost Privacy Policy for more information on the collection and use of information received through Mattermost services.
Access the following configuration settings in the System Console by going to Plugins > User Satisfaction Surveys.
Enable plugin
True: Enables the Mattermost Playbooks plugin on your Mattermost workspace.
False: Disables the Mattermost Playbooks plugin on your Mattermost workspace.
Enable user satisfaction survey
True: A user satisfaction survey will be sent out to all users on a quarterly basis. The survey results will be used by Mattermost, Inc. to improve the quality and user experience of the product. Please refer to the Mattermost Privacy Policy for more information on the collection and use of information received through Mattermost services.
False: User satisfaction surveys are disabled.
Zoom
Available on all plans
self-hosted deployments
This plugin allows team members to initiate a Zoom meeting with a single click. All participants in a channel can easily join the Zoom meeting and the shared link is updated when the meeting is over. See the Zoom Conferencing Plugin product documentation for details.
Note
To set up this plugin, you need to create a Zoom App using a Zoom Administrator account. See the Zoom Configuration documentation for details.
Access the following configuration settings in the System Console by going to Plugins > Zoom.
Enable plugin
True: Enables the Zoom plugin on your Mattermost server.
False: Disables the Zoom plugin on your Mattermost server.
Zoom URL
Specify the URL for a self-hosted private cloud or on-premise Zoom server. For example, https://yourzoom.com. Leave blank if you’re using Zoom’s vendor-hosted SaaS service.
Zoom API URL
Specify the API URL for a self-hosted private cloud or on-premise Zoom server. For example, https://api.yourzoom.com/v2. Leave blank if you’re using Zoom’s vendor-hosted SaaS service.
Enable OAuth
True: OAuth will be used as the authentication means with Zoom.
False: JWT will be used as the authentication means with Zoom.
Note
If you are currently using a JWT Zoom application and switch to OAuth, all users will need to connect their Zoom account using OAuth the next time they try to start a meeting. See the Zoom Configuration documentation for details.
OAuth by account level app (Beta)
True: Only an account administrator has to log in. The rest of the users will use their e-mail to log in.
False: All users must use their e-mail to log in.
Zoom OAuth client ID
Specify the Client ID for the OAuth app registered with Zoom. Leave blank if not using OAuth.
Zoom OAuth client secret
Specify the Client Secret for the OAuth app registered with Zoom. Leave blank if not using OAuth.
At rest token encryption key
Generate an AES encryption key for Zoom OAuth Token used to encrypt stored access tokens by selecting Regenerate. Regenerating the key invalidates your existing Zoom OAuth.
Webhook secret
Generate a secret for the webhook URL endpoint used to authenticate the webhook to Mattermost. Regenerating the secret invalidates your existing Zoom plugin.
Signature public key files
This setting isn’t available in the System Console and can only be set in config.json.
In addition to the Mattermost plugin signing key built into the server, each public key specified here is trusted to validate plugin signatures.
This feature’s |
Chimera OAuth proxy URL
This setting isn’t available in the System Console and can only be set in config.json.
Specify the Chimera URL used by Mattermost plugins to connect with pre-created OAuth applications.
This feature’s |
