Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Tutorial: How to start a new plugin Jira


Hello everyone,

I create this topic to help others who have problem to create a new plugin, and run the default Jira instance. Make this cause I passed many hours to try resolving problems when I try follow the Jira tutorial "Hello World", which is too old, or don't work to my computer (windows 10 family). I try many issues and now the origin project work and I want share this to you.



  • Install Java SE Development Kit (8 for me)
  • Install SDK Jira
  • Port 2990 free on your system


1- Create an add-on project using the atlas-create-jira-plugin command from a Command Prompt window :



2- You will be prompted to provide some information about your plugin. For the purposes of this tutorial respond to the prompts as follows:

Define value for groupId: : com.atlassian.tutorial
Define value for artifactId: : myPlugin
Define value for version: 1.0.0-SNAPSHOT: : 
Define value for package: com.atlassian.tutorial: : 

Value 1 and value 2 need to be complete. 3 and 4, just press 'ENTER'.


And complete following prompt with ' Y ' :

Y: : Y


 3- Now you can verify your installation works, need to have these components in the new ' myPlugin ' folder :




4- Need now to install different add-on before launching the server, start by prompt to go in the new folder:

cd myPlugin 

 And type :


An installation is launched, and appear a list of many options, you need to type no of the type of plugin you want :

Choose Plugin Module:
1: Component Import
2: Component
3: Component Tab Panel
4: Custom Field
5: Custom Field Searcher
6: Downloadable Plugin Resource
7: Gadget Plugin Module
8: Issue Tab Panel
9: Keyboard Shortcut
10: JQL Function
11: Licensing API Support
12: Module Type
13: Project Tab Panel
14: REST Plugin Module
15: RPC Endpoint Plugin
16: Report
17: Search Request View
18: Servlet Context Listener
19: Servlet Context Parameter
20: Servlet Filter
21: Servlet
22: Template Context Item
23: User Format
24: Version Tab Panel
25: Web Item
26: Web Panel
27: Web Panel Renderer
28: Web Resource
29: Web Resource Transformer
30: Web Section
31: Webwork Plugin
32: Workflow Condition
33: Workflow Post Function
34: Workflow Validator
Choose a number (1/2/3/4/5/6/7/8/9/10/11/12/13/14/15/16/17/18/19/20/21/22/23/24/25/26/27/28/29/30/31/32/33/34):

I already try Gadget plugin module (9) and web item (25), their works, but have no idea of others. In this example we take web item, it's a simple plugin which launches a url by clicking on the main bar button.

You will be prompted to provide some information about your plugin module. An answer like that :

Enter Plugin Module Name My Web Item: : Google Search
Enter Section (e.g. system.admin/globalsettings):
Enter Link URL (e.g. /secure/CreateIssue!default.jspa):

And type ' N ' 2 times to show advanced setup and another plugin module :

Show Advanced Setup? (Y/y/N/n) N: : N
Add Another Plugin Module? (Y/y/N/n) N: : N

5- Now the module is installed, you need to manually add a Debugger in your project, the first installer doesn't do this alone. Then edit your pom.xml, in ' myPlugin ' with an editing text software like NotePad++, and add this part :

<executable>C:\Program Files\Java\jdk1.8.0_121\bin\javac.exe</executable>

Modify the jdk path like being yours.

Your ' plugins ' part is now like that :




(Others plugin tags are hidden to minimize screenshot) 


6- It's finished ! Your plugin now work, just have to launch him with the command :


  When the server is launched, new lines stop to appear, and see this :

[INFO] Type Ctrl-D to shutdown gracefully
[INFO] Type Ctrl-C to exit

If the console say you connect to another port than 2990 (main Jira port) (example: localhost:50430/jira), you need to restart your PC, it reconfigure your ports automatically, now can restart your server with the same command than before :


You can now access your Jira local site, to ' localhost:2990/jira '.

The login page appear (default login is 'admin' and password 'admin') :




It's my first tutorial, thank to your comprehension, and sorry for my bad English (I'm french and not bilingual). If you have any questions, feel free to comment this tutorial.



 Matthieu DAVID



Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
Jan 22, 2018 • edited

Hi Matthieu,

That's awesome and I think a lot of people will benefit from this.

Thanks again!




Thanks for your tutorial! That help me a lot.

I created Listener module, now, how can I work on it in eclipse?


Fábio Coelho


Log in or Sign up to comment