Troubleshooting Mobile Applications

I keep getting a message “Cannot connect to the server. Please check your server URL and internet connection.”

Confirm that your server URL has no typos and that it includes https://.

Login with ADFS/Office365 is not working

In line with Microsoft guidance we recommend configuring intranet forms-based authentication for devices that do not support WIA.

I see a “Connecting…” bar that does not go away

If your app is working properly, you should see a grey “Connecting…” bar that clears or says “Connected” after the app reconnects.

If you are seeing this message all the time, and your internet connection seems fine, ask your server administrator if the server uses NGINX or another webserver as a reverse proxy. If so, they should check that it is configured correctly for supporting the websocket connection for APIv4 endpoints.

I’m not receiving push notifications on my device

Please see our documentation on troubleshooting push notifications.

Build gets stuck at bundleReleaseJsAndAssets

As a workaround, you can bundle the js manually first with

react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/ --assets-dest android/app/src/main/res/

and then ignore the gradle task with

./gradlew assembleRelease -x bundleReleaseJsAndAssets

No image previews available in the mobile app

This can happen if the server running Mattermost has its mime types not set up correctly. A server running Linux has this file located in /etc/mime.types. This might vary depending on your specific OS and distribution.

Some distributions also ship without mailcap which can result in missing or incorrectly configured mime types.

None of these solve my problem!

For more troubleshooting help, open a new topic in our forums with steps to reproduce your issue. If you’re an Enterprise Edition subscriber, you may open a support ticket in the Enterprise Edition Support portal.

To help us narrow down whether it’s a server configuration issue, device specific issue, or an issue with the app please try the following steps and include the results in your support request:

Connect to our community workspace

  1. Create an account at
  2. Delete your mobile application and reinstall it.
  3. In your mobile app, enter the server URL and then your login credentials to see if the connection is working.

Connect with another device

  • If you have another mobile device available, try connecting with that to see if your issue still reproduces.
  • If you don’t have another device available, check with other teammates to see if they are having the same issue.