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

Jira Cloud app: Hello World!

In this article we will develop a Jira Cloud app using atlassian-connect-spring-boot.

To follow this tutorial you would need maven, ngrok and IntelliJ Idea installed on your PC.

You can see the source code of this app here.

Create project with atlassian-connect-spring-boot

First we will create our project with atlassian-connect-spring-boot. To do it you need to execute the following command in your terminal:

mvn archetype:generate -DarchetypeGroupId=com.atlassian.connect -DarchetypeArtifactId=atlassian-connect-spring-boot-archetype

First, you will be asked to provide groupid, artifactid, version and package. I answered this way:

Define value for property 'groupId':
Define value for property 'artifactId': hello-world
Define value for property 'version' 1.0-SNAPSHOT: : 
Define value for property 'package' : 

Then confirm your input with the Y input:

Confirm properties configuration:
artifactId: hello-world
version: 1.0-SNAPSHOT
 Y: : Y

A new folder called hello-world will be created. Move to this folder with:

cd hello-world

Add a new page to your app

The entry point for Jira Cloud app is src/main/resources/atlassian-connect.json. This file is read by Jira Cloud when you install your app to a Jira Cloud instance.

Right now the contents of this file is the following:

  "key": "${addon.key}",
  "baseUrl": "${addon.base-url}",
  "name": "Hello World",
  "authentication": {
    "type": "jwt"
  "lifecycle": {
    "installed": "/installed",
    "uninstalled": "/uninstalled"
  "scopes": ["READ"]

Nothing much is going on there. We will add a new page to our app so that we could call this page from our Jira Cloud instance and get the "Hello World" message.

First let's add the following part to our atlassian-connect.json:

"modules": {
    "generalPages": [
        "key": "helloworld-page-jira",
        "location": "",
        "name": {
          "value": "Hello World"
        "url": "/helloworld"

These lines will add a menu to the menu with the "Hello World" label. Upon clicking on the "Hello World" label the /helloworld method will be called from our app. This helloworld method should return an html template with the "Hello World" message.

Add helloworld method

Create file src/main/java/ru/matveev/alexey/atlassian/cloud/tutorial/controller/ with the following text:


import com.atlassian.connect.spring.IgnoreJwt;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

public class HelloWorldController {

        public String helloworld() {
            return "helloworld";

Here we create a controller with the helloworld method which returns the helloworld view. This method has @IgnoreJwt annotation, which means that if we want to call this method, then the JWT token will not be checked (Atlassian uses JWT auth for Cloud apps. You can read more here). We need to ingnore the JWT token to test our app on our localhost. Later we will comment this annotation.

Create helloworld view

We will call our view with thymeleaf. That is why you need to add dependency into the pom.xml file:


Here is the complete pom.xml file so far:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="" xmlns:xsi="" xsi:schemaLocation="">







And now you can create the src/main/resources/templates/helloworld.html file with the following contents:

<!DOCTYPE html>
<html lang="en">
<section id="content" class="ac-content">
    <h1>Hello World</h1>
</html><!DOCTYPE html>
<html lang="en">
    <link rel="stylesheet" href="" media="all">
    <script src="" async></script>
<section id="content" class="ac-content">
    <h1>Hello World</h1>

Run our application on localhost

Now we can run our application on localhost. I run my application from IntelliJ Idea like this:

Screenshot 2020-08-26 at 14.26.42.png

After the program started we can call it with localhost:8080 in our browser. If everything works you should see the contents of atlassian-connect.json file:

Screenshot 2020-08-26 at 14.28.48.png

Now we can try our helloworld endpoint with localhost:8080/helloworld. You should see the Hello World message:

Screenshot 2020-08-26 at 14.29.52.png

Run in Jira Cloud

Comment @IgnoreJWT in our helloworld controller.

Create a Jira Cloud dev instance. You can find instructions here.

I do not have a static ip that is why I need ngrok to provide a tunnel to my pc so that I could connect to my app running on my localhost from internet. Our application runs on port 8080. That is why we need to launch ngrok with the following command:

./ngrok http 8080

Copy the https link to your application (your link will be different form mine):

Screenshot 2020-08-26 at 14.34.45.png

Now insert this link into src/main/resources/application.yml file for the base-url parameter:

spring.jpa.hibernate.ddl-auto: none
spring.datasource.url: jdbc:hsqldb:file:addon-db # Use a file-based backing store for HSQL

  key: hello-world
  base-url: DEBUG

Now run our application as before.

Connect your app to your Jira Cloud

Open your Jira Cloud dev instance, go to Manage Apps and click the Settings button:

Screenshot 2020-08-26 at 14.38.54.png

You will have the following screen:

Screenshot 2020-08-26 at 14.39.49.png

Check the Enable development mode checkbox and click the Apply button.

Then push the Upload App button and enter your https path from ngrok:

Screenshot 2020-08-26 at 14.42.01.png

Click the Upload button. After your app has been installed, you will see a confirmation screen:

Screenshot 2020-08-26 at 14.41.55.png

Now choose Apps -> Hello World:

Screenshot 2020-08-26 at 14.43.24.png

And you should see the Hello World message:

Screenshot 2020-08-26 at 14.54.03.png

Congratulations! Your app is working.

1 comment


Log in or Sign up to comment
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
May 4, 2021

Hi there! 
Thanks a lot for the article.


Just one thing: I've followed it and got error from jira (a tooltip saying "something went wrong"). Also got no errors/exceptions.

The issue was gone when I've updated html of my page with one given here

So I suppose it was a matter of absent js file in head section. 



AUG Leaders

Atlassian Community Events