Skip to Content
Author's profile photo John Appleby

How to install SAP HANA Studio for Mac OS X – and build your first XS app in HANA SP07

This is a pretty trivial thing but I keep looking for the URL and can’t find it, so it can’t be that easy to find. So I thought I’d write a document so I can find it in future. Maybe it helps someone else 🙂

As a bonus, we then go on to configure the Developer perspective and build our first Hello World XS app using the new HANA SP07 Team functionality.

There is no current supported version of SAP HANA Studio for Mac as of SP07 – we hope for a version to come in the future. But, there is an internal build that SAP use, and our friends at the SAP HANA Developer Center made it available for us to use! It is available on the SAP HANA Developer Center page. This version is usually a few revisions behind the current revision of SAP HANA Studio, and is only updated from time to time, and explicitly offers you no formal support.

Edit – for now, it’s not available on the Dev Center page but you can download the old version directly from here.

You can go ahead and download it now! I find the SAP HANA Developer Center gives me great download speeds, so it’s downloaded whilst I wrote this paragraph! It will appear in your downloads as a GZ file:

Screen Shot 2013-12-18 at 6.03.45 PM.png

Double click on the GZ file and it will quietly create a folder called hdbstudio, which you can navigate into. Be careful, because this folder will have an older date so you may not spot it!

Screen Shot 2013-12-18 at 6.06.37 PM.png

I copy this top level folder into the Applications folder – HANA doesn’t do this automatically, at least for now! I already have a version there, so it prompts me to copy it.

Screen Shot 2013-12-18 at 6.07.25 PM.png

Then, I open the hdbstudio folder and drag the hdbstudio Application onto my taskbar. It looks like this:

Screen Shot 2013-12-18 at 6.08.41 PM.png

If you are running a new-ish version of Mac OS X it won’t let you run this file – it will give you this error message: “hdbstudio” can’t be opened because it is from an unidentified developer.

Screen Shot 2013-12-18 at 6.09.43 PM.png

Not to worry… press Apple –> System Preferences –> Security & Privacy. You should see the following:

Screen Shot 2013-12-18 at 6.11.21 PM.png

You can go ahead and click Open Anyway!

Screen Shot 2013-12-18 at 6.11.52 PM.png

Click Open. Yay… along comes HANA Studio!

Screen Shot 2013-12-18 at 6.12.01 PM.png

Here it is in all its glory…

Screen Shot 2013-12-18 at 6.20.33 PM.png

If you’re new to SAP HANA, here’s how to connect. Click Open Administration Console –> Right click and click Add System

Screen Shot 2013-12-18 at 6.21.23 PM.png

Enter the system details, username and password and click “Save to Secure Storage”

Screen Shot 2013-12-18 at 6.22.07 PM.png

Now you have your HANA system, with the Rev.68 version on Mac you should be able to use the developer tools without regi.exe – and so do native development. Select Window -> Open Perspective -> Other -> SAP HANA Development and press OK:

Screen Shot 2013-12-18 at 6.26.48 PM.png

Select Repositories -> Create Repository Workspace:

Screen Shot 2013-12-18 at 6.29.15 PM.png

Screen Shot 2013-12-18 at 6.28.38 PM.png

You can now browse the repository workspace on your HANA Server. Here is some SAP-delivered content:

Screen Shot 2013-12-18 at 6.32.17 PM.png

Now you can click the Project Explorer View and select New -> Project:

Screen Shot 2013-12-18 at 6.32.56 PM.png

We have to drill in to find the HANA XS Project:

Screen Shot 2013-12-18 at 6.33.37 PM.png

As of HANA SP07 I can just give the project a name… and select the default location.

Screen Shot 2013-12-18 at 6.34.24 PM.png

Now I have to share my project back to the HANA Server using the Eclipse Team functionality. Right click your project and select Team –> Share Project:

Screen Shot 2013-12-18 at 6.35.31 PM.png

You can give it whatever name you want, depending on where you want your project to end up in the SAP HANA Repository. I choose a location provided to me as a test area. Note that by default the project will create a subfolder, so my location will actually be trainingContent.trainees.USER11.xstest:

Screen Shot 2013-12-18 at 6.38.52 PM.png

That’s it! My Project is configured and ready to go! Note that my project appears with a * next to it – meaning “unsaved”, until we have some active content.

Screen Shot 2013-12-18 at 6.40.11 PM.png

For bonus points… let’s go ahead and configure a simple Hello World scenario. Right click your project, select New -> Other and browse for the XS Application Descriptor File:

Screen Shot 2013-12-18 at 6.42.06 PM.png

Go through the wizard and finish up – don’t change any settings. Then right click, select Team -> Activate.

Screen Shot 2013-12-18 at 6.43.09 PM.png

Repeat the same with the XS Application Access file – and activate it. Your project should look like this, and you’re ready to go:

Screen Shot 2013-12-18 at 6.44.54 PM.png

Now let’s create a simple index.html – right click your project, select New -> File -> index.html. It will open in a browser so close the browser, right click index.html and select Open With -> Text Editor.

Screen Shot 2013-12-18 at 6.46.44 PM.png

Then type Hello World… Save… and activate. We’re done! Our Hello World example is exactly where you would hope. Note that it is our server name, followed by port (8000+system number), then our repository location that we configured, our project name, and index.html. Super simple!


Screen Shot 2013-12-18 at 6.48.29 PM.png

Final Words

I hope this helps someone get up to speed with HANA development fast! Note that if you are a HANA SP06 developer then this process is slightly different – and much simpler and more sensible.

A quick thanks to Rich Heilman and @Thomas_Jung for helping me out when I came to configure my first system. The differences between SP06 and SP07 left me confused.

Happy developing!

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Tammy Powlas
      Tammy Powlas

      I don't have a Mac but thank you for the detailed screen shots and sharing your experiences on SCN

      Author's profile photo John Appleby
      John Appleby
      Blog Post Author

      No worries - this will work if you have a PC apart from the installation process! Glad you enjoyed!

      Author's profile photo Former Member
      Former Member

      Hi John,

      I'm very new to HANA and I have a question about installing HANA on MAC OS X: what's about the HANA Client?

      I have read that the HANA Client runs only on Linux or WIndows...

      Is it suffient to just install HANA Studio?

      Many thanks,


      Author's profile photo John Appleby
      John Appleby
      Blog Post Author

      So the HANA client is the ODBC and JDBC drivers, which are available only for Linux and Windows. In SP6 of HANA you used to have to install the client to do development, and that is no longer the case in SP7.

      Of course, JDBC drivers are platform agnostic and you will see if you go to the SAP | HANA Developer Edition download page that there is a "HANA Driver" link which allows you to download the JDBC driver anyhow.

      Author's profile photo Former Member
      Former Member

      Dear Mentor  John Appleby we could learn a lot from your blog content .your work inspires  us 🙂

      Author's profile photo Former Member
      Former Member

      Vote for SAP HANA Studio for Mac!

      Author's profile photo John Appleby
      John Appleby
      Blog Post Author

      No need to vote - the Dev Center guys said that a version is coming. Just a matter of time 🙂

      Author's profile photo Former Member
      Former Member

      Good news!

      Author's profile photo Jouni Hooli
      Jouni Hooli

      Hi John, is the link to the build mentioned above still valid? I am getting only the standard SAP HANA Developer Center page. from this.

      Author's profile photo John Appleby
      John Appleby
      Blog Post Author

      Looks like it's gone for now 🙁

      I'll update once it's back up.

      Author's profile photo Former Member
      Former Member


      Any news on when the Mac version will return?

      Author's profile photo Vinoo Martin
      Vinoo Martin

      Not able to download. When you click on the link it is giving AccessDenied message

      Author's profile photo John Appleby
      John Appleby
      Blog Post Author

      Yes unfortunately this has been taken down until there is a stable version. Sorry.

      Author's profile photo Former Member
      Former Member

      Any next dates maybe?

      Author's profile photo John Appleby
      John Appleby
      Blog Post Author

      So my understanding is that new features will now only come out in SPS releases. So, we could optimistically hope for this in SPS08 in May/June.

      Author's profile photo Former Member
      Former Member

      Hi John,

      I also need a HANA studio for MAC. But the direct link you gave already not work.

      Could you please give me anther way to download it or send me by email ( ?

      Thanks you!

      Best Regards,

      Jackie Ju

      Author's profile photo Vinoo Martin
      Vinoo Martin

      You can install eclipse kepler and get the software add on from

      Author's profile photo Former Member
      Former Member

      An alternative variant is to build the native (formally not supported) Mac HANA Studio version yourself:

      Author's profile photo Ian Henry
      Ian Henry

      From SPS08 HANA Studio on Mac is now supported and revision 81 is available via the site mentioned by Vinoo,

      I have attempted to document this to make it easy for others to also install.

      How to install HANA Studio on Mac OSX using an Update Site

      Author's profile photo Denys Kempen
      Denys Kempen

      For those interested, I added a tutorial video to the SAP HANA Academy, part of the playlist on SAP HANA SPS 08 - installations

      SAP HANA Academy - SAP HANA installation: 5. Studio on Mac OS X - YouTube



      SAP HANA Academy