CINXE.COM

<!DOCTYPE html>  <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0" /> <meta name="author" content="Dennis Lundberg" /> <meta name="author" content="Karl Heinz Marbaise" /> <meta name="date" content="2007-07-24 2015-06-17" /> <title>Getting Help – Maven</title> <link rel="stylesheet" href="../css/apache-maven-fluido-2.0.1.min.css" /> <link rel="stylesheet" href="../css/site.css" /> <link rel="stylesheet" href="../css/print.css" media="print" /> <script src="../js/apache-maven-fluido-2.0.1.min.js"></script>  <script> var _paq = window._paq = window._paq || []; _paq.push(['disableCookies']); _paq.push(['trackPageView']); _paq.push(['enableLinkTracking']); (function() { var u="https://analytics.apache.org/"; _paq.push(['setTrackerUrl', u+'/matomo.php']); _paq.push(['setSiteId', '3']); var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0]; g.async=true; g.src=u+'/matomo.js'; s.parentNode.insertBefore(g,s); })(); </script>  </head> <body> <div class="container-fluid container-fluid-top"> <header> <div id="banner"> <div class="pull-left"><div id="bannerLeft"><h1><a href="https://www.apache.org/"><img class="class java.lang.Object" src="../images/apache-maven-project.png" /></a></h1></div></div> <div class="pull-right"><div id="bannerRight"><h1><a href=".././"><img class="class java.lang.Object" src="../images/maven-logo-black-on-white.png" /></a></h1></div></div> <div class="clear"><hr/></div> </div> <div id="breadcrumbs"> <ul class="breadcrumb"> <li><a href="https://www.apache.org/" class="externalLink">Apache</a><span class="divider">/</span></li> <li><a href="../index.html">Maven</a><span class="divider">/</span></li> <li class="active">Getting Help <a href="https://github.com/apache/maven-site/tree/master/content/apt/users/getting-help.apt"><img src="../images/accessories-text-editor.png" alt="Edit" /></a></li> <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2025-02-16</li> <li class="pull-right"><span class="divider">|</span> <a href="../scm.html">Get Sources</a></li> <li class="pull-right"><a href="../download.cgi">Download</a></li> </ul> </div> </header> <div class="row-fluid"> <header id="leftColumn" class="span2"> <nav class="well sidebar-nav"> <ul class="nav nav-list"> <li><a href="../index.html">Welcome</a></li> <li><a href="https://www.apache.org/licenses/" class="externalLink">License</a></li> <li class="nav-header">About Maven</li> <li><a href="../what-is-maven.html">What is Maven?</a></li> <li><a href="../maven-features.html">Features</a></li> <li><a href="../download.html">Download</a></li> <li><a href="../users/index.html"><span class="icon-chevron-right"></span>Use</a></li> <li><a href="../docs/history.html">Release Notes</a></li> <li class="nav-header">Documentation</li> <li><a href="../plugins/index.html">Maven Plugins</a></li> <li><a href="../extensions/index.html">Maven Extensions</a></li> <li><a href="../tools/index.html">Maven Tools</a></li> <li><a href="../guides/index.html">Index (category)</a></li> <li><a href="../users/index.html"><span class="icon-chevron-down"></span>User Centre</a> <ul class="nav nav-list"> <li><a href="../guides/getting-started/maven-in-five-minutes.html">Maven in 5 Minutes</a></li> <li><a href="../guides/getting-started/index.html"><span class="icon-chevron-right"></span>Getting Started Guide</a></li> <li class="active"><a>Getting Help</a></li> <li><a href="../run-maven/index.html">Running Maven</a></li> <li><a href="../guides/plugins/validation/index.html">Plugins Validation</a></li> <li><a href="../guides/mini/guide-configuring-plugins.html"><span class="icon-chevron-right"></span>Configuring Plugins</a></li> <li><a href="../guides/mini/guide-site.html"><span class="icon-chevron-right"></span>Creating a site</a></li> <li><a href="../guides/introduction/introduction-to-archetypes.html"><span class="icon-chevron-right"></span>Archetypes</a></li> <li><a href="../guides/introduction/introduction-to-repositories.html"><span class="icon-chevron-right"></span>Repositories</a></li> <li><a href="../guides/mini/index.html"><span class="icon-chevron-right"></span>Guides</a></li> <li><a href="../settings.html">Settings Reference</a></li> <li><a href="../pom.html">POM Reference</a></li> <li><a href="../general.html">FAQ</a></li> </ul></li> <li><a href="../plugin-developers/index.html"><span class="icon-chevron-right"></span>Plugin Developer Centre</a></li> <li><a href="../repositories/index.html"><span class="icon-chevron-right"></span>Maven Repository Centre</a></li> <li><a href="../developers/index.html"><span class="icon-chevron-right"></span>Maven Developer Centre</a></li> <li><a href="../articles.html">Books and Resources</a></li> <li><a href="../security.html">Security</a></li> <li class="nav-header">Community</li> <li><a href="../community.html">Community Overview</a></li> <li><a href="../project-roles.html">Project Roles</a></li> <li><a href="../guides/development/guide-helping.html">How to Contribute</a></li> <li class="active"><a>Getting Help</a></li> <li><a href="../issue-management.html">Issue Management</a></li> <li><a href="../scm.html">Getting Maven Source</a></li> <li><a href="../team.html">The Maven Team</a></li> <li class="nav-header">Project Documentation</li> <li><a href="../project-info.html"><span class="icon-chevron-right"></span>Project Information</a></li> <li class="nav-header">Maven Projects</li> <li><a href="../ref/current">Maven</a></li> <li><a href="../archetypes/index.html">Archetypes</a></li> <li><a href="../extensions/index.html">Extensions</a></li> <li><a href="../pom/index.html">Parent POMs</a></li> <li><a href="../plugins/index.html">Plugins</a></li> <li><a href="../skins/index.html">Skins</a></li> <li><a><span class="icon-chevron-down"></span>Components</a> <ul class="nav nav-list"> <li><a href="../archetype/index.html">Archetype</a></li> <li><a href="../resolver/index.html">Artifact Resolver</a></li> <li><a href="../doxia/index.html">Doxia</a></li> <li><a href="../maven-indexer/index.html">Indexer</a></li> <li><a href="../jxr/index.html">JXR</a></li> <li><a href="../plugin-testing/index.html">Plugin Testing</a></li> <li><a href="../plugin-tools/index.html">Plugin Tools</a></li> <li><a href="../apache-resource-bundles/index.html">Resource Bundles</a></li> <li><a href="../scm/index.html">SCM</a></li> <li><a href="../shared/index.html">Shared Components</a></li> <li><a href="../surefire/index.html">Surefire</a></li> <li><a href="../wagon/index.html">Wagon</a></li> </ul></li> <li class="nav-header">ASF</li> <li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a></li> <li><a href="https://www.apache.org/foundation/" class="externalLink">Foundation</a></li> <li><a href="https://privacy.apache.org/policies/privacy-policy-public.html" class="externalLink">Data Privacy</a></li> <li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a></li> <li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a></li> </ul> </nav> <div class="well sidebar-nav"> <div id="poweredBy"> <div class="clear"></div> <div class="clear"></div> <a href="https://maven.apache.org/" class="builtBy" target="_blank"><img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /></a> </div> </div> </header> <main id="bodyColumn" class="span10"> <section><a id="Getting_Help"></a> <h1>Getting Help</h1> <p>So something didn't work as you expected it to? You think that <i>Maven is broken</i>. What should you do?</p> <p>Here's a list of actions that you can take:</p><section><a id="You_did_check_the_documentation.2C_didn.27t_you.3F"></a> <h2>You did check the documentation, didn't you?</h2> <p>Apart from the central Maven site, each of our plugins has a website. Go to the <a href="../plugins/index.html">plugins page</a> and follow the link to the plugin you are having problems with.</p></section><section><a id="Try_the_latest_version_of_Maven_or_the_plugin_in_question"></a> <h2>Try the latest version of Maven or the plugin in question</h2> <p>Before you start intensive investigations on your problem, you should try to update Maven and/or the plugins in question to the latest stable release. After all, the issue you encounter might have been fixed already. To find out what is the latest stable release version, consult <a href="../download.html">Maven's download section</a> and the <a href="../plugins/index.html">plugin index</a>.</p></section><section><a id="Search_the_user-list_archives"></a> <h2>Search the user-list archives</h2> <p>Someone else might have experienced the same problem as you before. A list of mail-archives can be found on <a class="externalLink" href="https://maven.apache.org/mailing-lists.html">mailing list index page</a>. Please search one of them before going any further.</p></section><section><a id="Ask_on_the_user_list"></a> <h2>Ask on the user list</h2> <p>Our community is very helpful, just ask it the right way. See the references section, at the end of this page, for info on how to do that. Subscribe to the <a class="externalLink" href="https://maven.apache.org/mailing-lists.html">users-list</a> and describe your problem there. Don't expect to get an answer right away. Sometimes it takes a couple of days.</p></section><section><a id="Submit_an_issue"></a> <h2>Submit an issue</h2> <p>If it turns out that there is indeed something wrong with Maven or one of the plugins, you should report it to our issue management system JIRA.</p> <p>You don't need create JIRA issue only to ask us something - in such case please first ask on <a class="externalLink" href="https://maven.apache.org/mailing-lists.html">users-list</a></p><section><a id="Request_new_JIRA_account"></a> <h3>Request new JIRA account</h3> <p>Requesting for JIRA account is preferred if you plan to contribute to project by coding or testing by longer time.</p> <p>This is so that we can communicate with you while we work together on the issue.</p> <ul> <li>please use your real name and surname if possible in public name field</li> <li>links to your public projects, social or professional profile can be appreciated</li> <li>you can also tell us a little about yourself and what you intend to use this account for</li></ul> <p>Such information is useful to verify that account is requested for real user not a bot.</p> <p>Go to the <a class="externalLink" href="https://selfserve.apache.org/jira-account.html?project=maven">Request a JIRA account</a> to request for a new account if you don't already have one.</p></section><section><a id="Where.3F"></a> <h3>Where?</h3> <p>If the problem is in one of the plugins, check the site of that plugin to get the correct link. Each plugin has its own section in JIRA, so using the correct link is important. Click on <i>Project Information</i> and then <i>Issue Management</i>. On that page you will find the correct link.</p> <p>If the problem is in Maven itself you can find the appropriate link on the <a class="externalLink" href="https://maven.apache.org/issue-management.html">issue management</a> page.</p></section><section><a id="How.3F"></a> <h3>How?</h3> <p>Just describing the problem is not enough. It takes a developer a lot of time to make a usable POM to even attempt to assess the problem. Issues that states problems without something usable to try out will be closed as incomplete.</p> <p>Please attach a working POM, or a set of POMs, that we can download and run. We appreciate reports, but if you don't have something usable for us it's incredibly hard for us to manage the issues. A POM goes a long way to helping us resolve problems. </p> <p>Create a POM that can be used to verify that it is a bug. If your pom uses plugins, make sure that you have specified the version for each and every plugin. If you don't, then we might not be using the same version as you are when we test it.</p> <p>What we like best are patches that fixes the problem. If you want to create a patch for an issue please read the <a href="../guides/development/guide-maven-development.html">Maven Developer Guide</a> first.</p></section></section><section><a id="References"></a> <h2>References</h2> <ul> <li><a class="externalLink" href="http://www.catb.org/~esr/faqs/smart-questions.html">How To Ask Questions The Smart Way</a></li> <li><a class="externalLink" href="http://opensourcestrategies.blogspot.com/2005/09/how-to-get-support-from-open-source.html">How to Get Support from Open Source Mailing Lists</a></li></ul></section></section> </main> </div> </div> <hr/> <footer> <div class="container-fluid"> <div class="row-fluid"> <p>© 2002–2025 <a href="https://www.apache.org/">The Apache Software Foundation</a> </p> </div> </div> </footer> </body> </html>