Unable to Access Confluence with error "There should be at least one AvatarProvider module registered in the plugin system"

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

When attempting to access Confluence, you see the error 'There should be at least one AvatarProvider module registered in the plugin system.'

Environment

Confluence 7.18.3

Diagnosis

When Confluence starts, we see the following messages in the atlassian-confluence.log file.

1 2 2023-03-17 13:45:16,338 ERROR [Catalina-utility-1] [atlassian.plugin.util.FileUtils] conditionallyExtractZipFile Found file:/opt/software/confluence/atlassian-confluence-7.18.3/confluence/WEB-INF/atlassian-bundled-plugins, but failed to read file java.io.FileNotFoundException: /opt/software/confluence/atlassian-confluence-7.18.3/confluence/WEB-INF/atlassian-bundled-plugins (No such file or directory)

We can also see Confluence complains about plugins, and finally, it prints the AvatarProvider module message.

1 2 3 2023-03-17 13:45:38,783 ERROR [Catalina-utility-1] [plugin.osgi.factory.OsgiPluginInstalledHelper] availableForTraversal Cannot determine required plugins, cannot resolve bundle 'com.atlassian.confluence.plugins.confluence-edge-index' 2023-03-17 13:45:38,785 ERROR [Catalina-utility-1] [plugin.osgi.factory.OsgiPluginInstalledHelper] availableForTraversal Cannot determine required plugins, cannot resolve bundle 'com.mxgraph.confluence.plugins.diagramly' 2023-03-17 13:45:38,855 ERROR [Catalina-utility-1] [plugin.osgi.factory.OsgiPlugin] enableInternal Detected an error (BundleException) enabling the plugin 'com.atlassian.confluence.plugins.confluence-edge-index' : Unable to resolve com.atlassian.confluence.plugins.confluence-edge-index [17](R 17.0): missing requirement [com.atlassian.confluence.plugins.confluence-edge-index [17](R 17.0)] osgi.wiring.package; (osgi.wiring.package=com.atlassian.confluence.plugins.rest.dto) Unresolved requirements: [[com.atlassian.confluence.plugins.confluence-edge-index [17](R 17.0)] osgi.wiring.package; (osgi.wiring.package=com.atlassian.confluence.plugins.rest.dto)]. This error usually occurs when your plugin imports a package from another bundle with a specific version constraint and either the bundle providing that package doesn't meet those version constraints, or there is no bundle available that provides the specified package. For more details on how to fix this, see https://developer.atlassian.com/x/mQAN
1 2 3 2023-03-17 13:45:50,380 INFO [http-nio-8080-exec-3] [atlassian.confluence.status.SystemErrorInformationLogger] writeToLog --- javax.servlet.jsp.jspException: java.lang.IllegalStateException: There should be at least one AvatarProvider module registered in the plugin system.

Cause

Solution

  • Ensure Confluence application user has access to the atlassian-bundled-plugins directory and atlassian-bundled-plugins directory exists in <confluence-install>/confluence/WEB-INF and Confluence user has access permissions to it.

  • If the atlassian-bundled-plugins directory is missing, you can install a similar Confluence version and similar plugins on a test environment and copy the atlassian-bundled-plugins directory from the test environment.

Updated on March 3, 2025

Still need help?

The Atlassian Community is here for you.