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 > 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.
   

3. Enter the Matomo installation URL.

4. Enter the generated token_auth.
   

5. Click Login.

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