KB : Installation of Jira localhost instance on MacBook with M1 ARM processor

Purpose

This page describes the way how to set up your own Jira instance using Linux Virtual Machine and a standalone version of Jira.

  • Atlassian does not support installing Jira on OS X or macOS

  • OpenJDK 11 required for Jira 8.x is not available on macOS aarch64

Preconditions:

Parallels - download and install parallels according to https://www.parallels.com/products/desktop/trial/

Ubuntu 20.04- download and install ubuntu according to https://kb.parallels.com/en/128445

Runbook:

1. Download Jira standalone

  • It is recommended to perform as ubuntu root account (to avoid permission issues)

  • Create a separate Jira directory and move “atlassian-jira-software-8.22.3.tar.gz” Jira package to ubuntu, for example in the following localization:

    root@ubuntu-linux-20-04-desktop:/home/parallels# mkdir jira root@ubuntu-linux-20-04-desktop:/home/parallels# mv atlassian-jira-software-8.22.3.tar.gz /home/parallels/jira/
  • Unpack package using tar:

    root@ubuntu-linux-20-04-desktop:/home/parallels# tar -zxvf atlassian-jira-software-8.22.3.tar.gz

2. Install a specific version of OpenJDK manually

  • Download OpenJDK-11-jdk - ubuntu will recognise ARM architecture and will install correct version for VM OS.

    root@ubuntu-linux-20-04-desktop:/home/parallels# apt install openjdk-11-jdk
  • Check java version

  • Alternatively, If java does not return version values, setup $JAVA_HOME, for example:

3. Run Jira instance

  • create a Jira home directory and setup $JIRA_HOME:

  • run Jira instance using shell script:

  • Check if Jira is up&running:

  • Alternatively, you can access your Jira directly from your MacBook:

    • Check IP served by VM:

    • Access Jira from the browser over port 8080:

 

This local instance makes it possible to install addons from Atlassian marketplace and reproduce issues in the local environment.


In case of any issues contact @Konrad Szkudlarski .