This guide provides steps to install the MSI and use Group Policies in Windows Professional or Enterprise. The MSI installer package can be downloaded here.
The Mattermost MSI installer and Group Policy (GPO) definitions are in Beta. If you are using this installer or GPOs and have feedback, particularly if you are an organization executing remote deployments, please contact us in the MSI Installer channel on our Community server or on our community forum. We hope to promote this installer out of Beta when the known issues are addressed and we are confident that the various deployment scenarios expected in production environments are tested sufficiently with the help of organizations using this Beta. Feedback is highly appreciated.
On this page
Using a newly created Windows VM or dedicated Windows computer, make sure to use a Windows version that supports
Edit group policyout of the box (i.e. Windows 10 Pro or Enterprise).
Navigate to the release page for version v5.5.1 and download the appropriate installer for your version of Windows (32-bit vs. 64-bit).
Download the source.zip file as well to extract group policy files.
Browse to the folder the above files were downloaded to and unzip the
desktop-5.5.1.zipfile in place.
Navigate to the unzipped
desktop-5.5.1\resources\windows\gpofolder and copy the contents.
Navigate to the
C:\Windows\PolicyDefinitionsfolder and paste the files copied in the last step.
mattermost.admxfile is in the
mattermost.admlfile is in the
\\FQDNDomain\sysvol\FQDNDomain\Policies\PolicyDefinitionscan be used instead of
\\FQDNDomain\sysvol\FQDNDomain\Policies\PolicyDefinitions\en-UScan be used instead of
Edit group policyapplication by selecting Start, typing
gpeditinto the search field, then selecting the resulting Edit group policy search option.
In the Edit group policy window, navigate to
Local Computer Policy\Computer Configuration\Administrative Templates\Mattermost. In this example, double-click on
DefaultServerListto set one or more default servers that will appear on app launch.
In the resulting window for DefaultServerList, select Enabled to turn the feature on, then select the Show… button in the Options: section of the window to add default servers.
In the resulting window, add desired Mattermost servers using a memorable name (i.e., Community) and the web URL of the Mattermost server (i.e., https://community.mattermost.com).
Select OK twice, then close the Edit group policy app.
Open up the Registry Editor by selecting Start, typing
Registry Editorin the search field, then selecting the Registry Editor option in the search results.
In the Registry Editor window, navigate to
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Mattermost\DefaultServerListand verify the servers you added using the Edit group policy app are listed.
Once verified, close the Registry Editor.
Within the folder the MSI installer was downloaded to, double-click on the MSI installer to begin the Mattermost Desktop installation process.
Installation of the MSI requires admin permission, so accept the resulting request to allow the installer to make changes to your device.
Select Finish when the installation is complete.
Launch the newly installed Mattermost app from the Start menu.
Verify the app loads the first server you defined in the Edit group policy app.
Perform a silent installation of MSI by running the following command:
msiexec /i mattermost-desktop-v5.5.1-x64.msi /qn
You’ll need to change this command as new versions of the Mattermost Desktop App are released.