Apache Maven 1.x has reached its end of life, and is no longer supported. For more information, see the announcement. Users are encouraged to migrate to the current version of Apache Maven.


How to use this plugin?

1. The jira plugin needs the jira id number of your project to work. Preferably, your project.xml should have an <issueTrackingUrl> in the following format :

<issueTrackingUrl>[JIRA URL]/BrowseProject.jspa?id=[JIRA PROJECT ID]</issueTrackingUrl>

Example :


If no id is found in <issueTrackingUrl>, like eg, in


an attempt is made to extract the id from the jira project page, but this is not guaranteed to work.

2. Determine the credentials to log into the webserver, if any. The plugin supports basic authentication (and SSL). Add the credentials to the project.properties, as maven.jira.webUser and maven.jira.webPassword

3. Determine the JIRA account to login to the JIRA installation. Add the credentials to the project.properties, as maven.jira.jiraUser and maven.jira.jiraPassword

4. log out of jira (if you are using Remember me feature) and test your setup by going to url like this one:

[JIRA URL]/secure/IssueNavigator.jspa?view=rss&pid=[JIRA PROJECT ID]&sorter/field=issuekey&sorter/order=DESC&sorter/field=status&sorter/order=DESC&tempMax=1000&reset=true

Example :


5. add this to your project.xml in reports section


6. run maven site (or just maven maven-jira-plugin:report xdoc) and you should have jira.html in your ${basedir}/target/docs directory

My JIRA installation runs SSL with a self signed/home brewn certificate. I get an error message that the certificate is untrusted. How do I proceed?

Add the server certificate to your JAVA. You can get the certificate by exporting it from your browser. With IE you click on the certificate info, go to the details TAB and export as .DER by clicking on 'Copy to File...'. Using SUN's keytool you can import the certificate in your 'truststore'. It is located in $JAVA_HOME/jre/lib/security/cacerts Import it using

keytool -import -file <servercert>.cer -keystore cacerts