What you'll need
In order for your users to try the Confluence Server mobile app, you will need to:
- upgrade your Confluence site to Confluence 6.8 or later
- ensure your site is using HTTPS, and that your certificate is from a trusted Certificate Authority
- allow users to access your site on their device (if your site isn't accessible on the public internet, people will need be connected to your network or use a VPN)
In order to use the app, your users will need a device with either:
- Android 4.4 (KitKat) or later, or
- iOS 11 or later (iPhone, iPad or iPod Touch)
Users will need to log in to use the app, even if your site allows anonymous users.
Considerations for administrators
Here are some things to consider when determining whether your users will be able to use the app.
VPN and firewalls
If your Confluence site is not accessible on the public internet, users will need to connect their device to your network or virtual private network (VPN) in order to use the app.
We recommend providing your users with step-by-step instructions on how to connect to your VPN when you let them know the mobile app is available, as this is something Atlassian Support will not be able to help them with.
To use the app your site will need to be configured to use HTTPS and your proxy must allow TLS 1.2 traffic.
These requirements often come from the mobile platform itself, not Confluence. For example HTTPS and TLS1.2 is an iOS requirement that we've chosen to implement for both the iOS and Android apps to prevent confusion (for example where one device can log in, and another cannot).
There are also some certificate requirements. You won't be able to log in to the app if:
- your certificate is self signed
- the Certificate Authority (CA) is unknown, or is not one that Android / iOS trusts by default (for example it might be a new CA that is not yet trusted, a private CA, or you are your own CA)
- your certificate is missing an intermediate CA, affecting the certificate chain.
See our Knowledge base article for more information on how to resolve this.
Login and authentication
The app supports all common Confluence user management configurations, including external user directories and SAML single sign-on. Users will need to sign in to use the app, even if your site allows anonymous access.
Mobile Device Management (MDM)
We do not currently support any mobile device management (MDM) or app management solutions.
Third party add-ons, themes, and visual customizations
The mobile app provides a simple, lightweight way for users to view, create, edit and collaborate on pages. Complex interactions, including those provided by add-ons, such as blueprints, calendars, workflows will not be available in the app. Some third party macros may be available, depending on whether the add-on supports rendering these macros on mobile.
Any theming or look and feel customizations you've made to your site will not be reflected in the app.
In order to provide push notifications to users' devices, we have developed a cloud-based notification service. This service is developed and maintained by Atlassian, and is hosted on our AWS infrastructure (AWS SNS). See Push notifications service below for more information.
This is the only cloud-based service used by the app.
Push notifications service
The Confluence Server mobile app can push notifications directly to users' devices. Users choose whether they'd like to receive push notifications from the app, and can opt out at any time. This feature uses a cloud-based notifications service developed and maintained by Atlassian and hosted on our AWS infrastructure. No user or message content is sent to the service, only notification IDs, and we don't store any data.
If you need to avoid using any cloud-based services you can choose to disable push notifications entirely. Head to > General Configuration > Mobile apps.
If you're using restrictive firewall or proxy server settings, you'll need to allow (whitelist)
https://mobile-server-push-notification.atlassian.com to ensure push notifications work as expected.
For sites that are not accessible on the public internet (for example users need to be connected via VPN to use the app) we adapt the push notification message as follows:
- If the user is connected to your network or VPN, we'll show the full notification, for example "Sara Leung shared 'End of year party' with you"
- If the user is not currently connected to your network or VPN, we'll show a shorter notification, for example "1 new notification".
Mobile web and linking directly to pages
It is not possible to go directly from a link, for example in an email notification, to the app. To help with this limitation, when people land on a Confluence page in their device's browser, they'll see the Open in app button. Tapping this prompt will open the app, if they have it installed, or take them to the App or Play store to download it.
If you don't want this button to display in mobile web, you'll need to disable the entire Confluence Mobile plugin, which is required to use the mobile app.
Limitations and known issues
Not all macros are available
Not all macros will display in the app or mobile web. If a macro can't be displayed, you'll see the message below, and have the option to tap through to the desktop version of the page, in your device's browser.
Screenshot: Error that appears when a macro is not rendered in Confluence mobile
Administrators can disable Confluence mobile on your site
If you're not able to use the mobile app or mobile web, it may be because your administrator has disabled one or both of the following system add-ons:
- Confluence mobile plugin (required to use the mobile app)
- Confluence mobile web plugin (required to use mobile web)
In Confluence versions 5.9 and above, disabling the Confluence Mobile Plugin will also disable all the modules of the Workbox - Host Plugin plugin. This issue is being tracked at - CONFSERVER-40782Getting issue details... STATUS
Seperate Cloud and Server apps
While the functionality of the two apps is very similar, you will need to download the Confluence Server mobile app to be able to authenticate with a server site. You can't use the Confluence Cloud app with a Confluence Server site or vice versa.