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

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Installing Atlassian SDK on macOS Edited

Are there any pointers on how to install Atlassian SDK on macOS Catalina?

Whenever I try to do so I get the following error message from install4j installer: 

You must be logged in as a root user when installing this program

3 answers

0 votes

Hello Igor,

Thank you for raising this. I'm getting the same error as you.

I'm checking with the team, but I was able to install the SDK using the Homebrew instructions for Linux:

If you don't have Homebrew installed, you can follow the instructions on

Can you give that a try and let me know if it works?



Hi Shannon,

I'm not a Homebrew user and installed SDK manually, but I would prefer to install it from the package.

It should be a matter of configuration according to install4j documentation if I understand it correctly (see p. 98):


No worries! I reported it to the team, and have logged it as a bug below:

  • ATLASSDK-190 Atlassian Plugin SDK Installer returns "must be logged in as root" error on macOS Catalina (10.15)

You should be able to view it as well, so please confirm with me. If you vote or watch the case, you'll receive updates once it's resolved.

Take care!



Like Ivan Lima likes this

hi Atlassian team,

just verified that the ticket referenced above was closed with a reference to the Homebrew installer. You might want to update the Atlassian SDK Developer documentation accordingly:

Kind regards,


Hi Georg,

Apologies for the late response! The referenced ticket is closed because there is an internal ticket to track its progress. The usage of Homebrew was my suggestion for a workaround in the meantime.

We discovered what caused the problem and are currently working on the fix. I will update here if I find any information about when that is released!

Thank you, and take care.



Hello @Georg Federmann@Martin, and @Calum, and anyone else who has experienced this issue.

I have confirmation from the team that this is now working as expected. I tested, and I can install SDK 8.2.6 on Catalina version 10.15.7 without the use of Homebrew.

If you are still encountering any issues, could you confirm the SDK version and your macOS version?

Thank you!

The 8.2.6 installer still doesn't work for me on 10.15.7 without the workaround I mentioned. The installer has no permission to write to /Applications unless you're an admin user, so it has to be run from command line with sudo instead.

Screenshot 2021-02-08 at 23.20.24.pngScreenshot 2021-02-08 at 23.22.14.png

Would it be possible to fix the problem? I am not allowed to have Homebrew(don't ask). Another alternative would be to give explicit, step by step, directions to install it manually.

I've just had to work around this too... the solution is to open the DMG file, then run:

sudo /Volumes/atlassian-plugin-sdk/Atlassian\ Plugin\ SDK\ 8.2.6\

(You may have to change the version number if it's been updated by the time you read this.)

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Confluence

🏑 Atlympic Event: Confluence

Hello Community!  Quick disclaimer: We are running a contest on Community (The Atlympics!) from July 23rd - August 8th of 2021. If you are interested in participating in this contest (prizes! ...

313 views 12 9
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you