Troubleshoot sign-in

How you install Explorer depends on your InfluxDB 3 server

Starting with InfluxDB 3 Enterprise v3.11, Explorer is included with the server and runs as WebAssembly (WASM)–there’s no separate container to install. Docker is required for InfluxDB 3 Core and Enterprise earlier than v3.11, and remains an option for later Enterprise releases. See Install Explorer to find the instructions for your server.

Find the fix for a InfluxDB 3 Explorer sign-in problem by its symptom. Most symptoms appear as messages on the Sign in page.

Find your symptom

Explorer doesn’t require sign-in

The server doesn’t have user authentication turned on, or the server is InfluxDB 3 Core. InfluxDB 3 Enterprise doesn’t require sign-in when you start it with --user-auth-type none or --without-auth. See When Explorer requires sign-in.

Incorrect username or password

The server didn’t accept the username and password. Explorer displays the same message for an unknown username and for an incorrect password.

If the message persists, one of the following might apply:

  • Your user signs in with SSO only. A user that an administrator adds with the SSO method doesn’t have a password. Click Sign in with SSO instead.
  • The password is lost. An administrator can’t reset a password. See Forgotten passwords.

Explorer can’t reach the server

Explorer displays one of the following messages:

Could not reach this server to check how to sign in. Check that it is running, then reload the page.
Could not reach this server to sign you in. Check that it is running, then try again.

On the setup page, the message is the following:

Could not reach this server. Waiting for it to come back.

Check that the InfluxDB 3 server is running and that Explorer can connect to it. Explorer continues to require sign-in while it can’t reach the server.

The server can’t sign users in

Explorer displays one of the following messages:

This deployment has user authentication enabled but cannot issue credentials, so nobody can sign in.
This server has user authentication enabled but offers no sign-in method this application can use.

The server has user authentication turned on, but doesn’t have a key to sign credentials or an identity provider to issue them. Restart the server with one of the following:

  • --jwt-key-id and --jwt-private-key for password sign-in
  • --oauth-client-id for an identity provider

The server also turns off password sign-in when the private key isn’t in PKCS#1 format, or when you set only one of the two options.

For more information, see Configure JWT signing keys in the InfluxDB 3 Enterprise documentation.

Someone already set up the server

Explorer displays the following message:

This deployment has already been set up.

Someone created the first user from another browser or with the CLI. Sign in with that user, or ask the person who created the user to add a user for you.

The server has an operator token but no users

Explorer opens the Sign in page, but nobody has a user to sign in with.

Explorer opens the setup page only for a server that has no users and no operator token. A server that used token authentication before you turned on user authentication already has an operator token.

Create the first user with the influxdb3 CLI and the operator token. See influxdb3 CLI.

Identity provider sign-in fails

Explorer displays the following message, followed by the reason that the server reported:

Could not sign you in with your identity provider.

The cause is one of the following:

The server doesn’t have a user for your identity

The reported reason includes your identity. Ask an administrator to add a user with that identity as the OAuth ID, either in Explorer or with the influxdb3 CLI–for example:

influxdb3 create user --oauth-id 
SUBJECT
--role
ROLE

Replace the following:

  • SUBJECT: the identity that Explorer reported
  • ROLE: the role to assign to the user

The Explorer Docker container is missing an SSO setting

If you run the Explorer Docker container, the reported reason can name a problem with the container’s SSO settings:

  • Requested resource is unavailable: EXPLORER_OAUTH_REDIRECT_URI isn’t set.
  • The identity provider refused the sign-in: unauthorized_client: your identity provider expects a client secret. Set EXPLORER_OAUTH_SECRET.

See Configure single sign-on.

The server doesn’t accept tokens from your identity provider

The issuer or audience that the server expects is different from the one that your identity provider sends. Ask an administrator to check the identity provider settings of the server. See Authenticate with OAuth/OIDC in the InfluxDB 3 Enterprise documentation.

Sign in with SSO isn’t available

Explorer displays the following message:

This server signs people in through an identity provider, but this application is not configured for it.

The server uses an identity provider, but Explorer isn’t configured to start SSO.

  • For the integrated Explorer UI, start the server with --webui-public-uri set to the URL that you use to open Explorer. See Configure SSO for the Explorer UI in the InfluxDB 3 Enterprise documentation.
  • For the Explorer Docker container, set EXPLORER_OAUTH_CID and EXPLORER_OAUTH_REDIRECT_URI. The message names --webui-public-uri in the container too, but that option doesn’t apply to it. See Configure single sign-on.

Was this page helpful?

Thank you for your feedback!