Deploy Mattermost mobile apps#

plans-img Available on all plans

deployment-img Cloud and self-hosted deployments

This documentation provides foundational information you need when developing a plan for an enterprise mobile application deployment. It’s intended for business leaders, system administrators, and mobile app developers responsible for deploying Mattermost in their organization.

This documentation provides information to help you:

  • Determine the ideal mobile deployment model for your organization.

  • Understand what’s required to build your own Mattermost Mobile Apps.

  • Deploy Mattermost mobile apps.


  • Mattermost Cloud customers must use Mattermost pre-built public apps for mobile deployment.

  • Some features described in this guide are available only in Mattermost Enterprise Edition.

Decision summary#

When planning for a mobile app deployment, you have two important decisions to make:

  • What app will you deploy - a pre-built app or your own custom build?

  • How will you deploy it?

Mattermost provides official mobile apps through public app stores including the Apple App Store and the Google Play Store. These apps are referred to throughout this documentation as Mattermost’s pre-built mobile apps. Using Mattermost’s pre-built apps is the easiest and fastest approach since your users can download the apps from public app stores, or you can use an EMM provider to maintain full control over the distribution process or enforce or restrict specific security policies. See Using Mattermost’s Pre-Built Apps to learn more about using Mattermost pre-built apps.

If you want to control the app’s look and feel, or host your own push proxy server, you can build your own mobile apps and manage your own app distribution. See Building and Distributing Your Own Custom Mattermost Mobile Apps to learn more about working with custom built apps.

The following table summarizes the key differences between these two approaches:

Use Pre-Built Apps (Highly Recommended)

Build Custom Apps (Not Easy)

Recommended for:

Self-supporting teams who need standard features.

Recommended for:

Teams that need to customize the app, or prefer to host their own push proxy server.


  • Easiest way to deploy Mattermost Apps.

  • Test push notifications using Mattermost mobile push proxy options.

  • Apps update automatically with the latest features enhancements, and security updates.


  • Can’t white-label Mattermost Mobile Apps.

  • Can’t deploy your own push proxy server.


You maintain full control over the look and feel of your mobile app.


  • Requires development knowledge and resources to maintain mobile app code as Mattermost releases new product updates.

  • Must deploy your own push proxy server.

Technical and Security Requirements#

See our Supported Devices/Mobile Device Requirements documentation for basic mobile device requirements, and our Supported Mattermost Server Versions documentation for details on Mattermost Server minimum requirements.

We recommend running the latest version of the Mattermost Server and the Mattermost Push Notification Service (MPNS) as they contain the most recent features and applicable security updates.

If this isn’t possible, we encourage you to be on the most recent Extended Support Release version of Mattermost Server. This release has critical feature updates that will ensure compatibility in a number of areas, including the Mattermost Push Notification Service (MPNS).


Not all provided updates are compatible with all previous versions of Mattermost. Updating only Mattermost Mobile Apps or updating the Mobile apps before updating Mattermost Server can result in compatibility issues.

You should also start thinking about technical and security requirements in parallel with an implementation plan. Feel free to use our implementation plan template available in the Mattermost documentation.

Also, start engaging your technical and security teams with the following questions:

Asking questions like these requires you to pause before jumping into your Mattermost mobile project. However, it will help ensure you see a return on your investment.

Getting Help#

If you need assistance, please reach out using one or more of the following methods.

  • Community: Join our Mattermost community and post your specific questions in the Developers: Mobile channel.

  • Documentation: We link to a lot of mobile-specific documentation within this guide, but we encourage you to visit all of our product documentation.

  • Forums: For more troubleshooting help, open a new topic in our forum and include the steps to reproduce your issue so we can test on our side.

  • GitHub: Visit us on GitHub to create issues in any of our repositories.

  • Enterprise Support: If you’re a Mattermost Enterprise Edition subscriber, open a support ticket in the Enterprise Edition Support portal.