How to use the Matomo Mobile App when using SAML Authentication?

If your Matomo instance uses SAML authentication (and possibly LDAP), the standard login method will not work in the Matomo mobile app.

Instead, you must generate an authentication token (token_auth) to log in. The token acts as a password replacement, allowing the mobile app to authenticate your user account securely.

Create the Authentication Token

  1. First, log in to your Matomo instance via a web browser.
  2. Navigate to Administration Settings Settings Cog Icon > Personal > Security and generate an Authentication Token (token_auth).

Log in to the Mobile App using the Authentication Token

  1. Open the Matomo mobile app.

  2. Use the option, Click to log in using app-specific auth token.
    login matomo mobile app

  3. Enter the Matomo installation URL.

  4. Enter the generated token_auth.
    login matomo mobile app

  5. Click Login.

This will authenticate your mobile app session without requiring SAML authentication.

Previous FAQ: How do I track users of my own Android or iOS mobile app using Matomo?