How to install SAP GUI for Mac (SAP GUI for Java)

There's no "SAP GUI for Windows" on macOS — instead, Mac users run SAP GUI for Java, a separate client that provides the same core logon and transaction experience. This guide covers what it is, what you need, and how to install it.

SAP GUI for Java vs SAP GUI for Windows

SAP ships two desktop clients: SAP GUI for Windows (Windows only) and SAP GUI for Java (cross-platform — macOS, Linux and Windows). On a Mac you use the Java edition. It connects to the same SAP systems and runs the same transactions, though a few Windows-only features and some visual polish differ.

The two clients also store their connection lists differently, so the SAPUILandscape.xml file from a Windows machine is not directly interchangeable with the Java client's configuration.

What you need first: Java

SAP GUI for Java requires a Java runtime (JRE/JDK). SAP publishes the supported Java versions for each SAP GUI for Java release in its release notes, so check which Java version your SAP GUI for Java version needs, and install that first. On Apple Silicon Macs (M1/M2/M3), make sure you use a Java build that matches — SAP's notes state which architectures are supported.

Step 1 — Get the installer

Like the Windows client, SAP GUI for Java is licensed software. Download it from your organisation's software portal, or from the SAP Software Download Center if you have SAP customer credentials. You'll get a macOS package (typically a .JAR installer or a .dmg, depending on the release).

Step 2 — Run the installer

Launch the downloaded installer and follow the prompts. Because it's a Java application, the installer may run through Java rather than as a native .app. If macOS blocks it as coming from an unidentified developer, allow it under System Settings → Privacy & Security.

Step 3 — Launch and add a connection

Open SAP GUI for Java. To add a system, open the connection manager and enter the details your Basis team provides — application server or message server, system ID, instance number, and a SAP router string if required. You can also paste a full connection string. Save it and connect.

Alternatives on Mac

If SAP GUI for Java doesn't fit your workflow, two common alternatives are:

• SAP Fiori / web access — many modern SAP tasks are available through the browser, no desktop client needed.
• Windows in a VM or Remote Desktop — run SAP GUI for Windows inside a virtual machine (Parallels, VMware) or connect to a Windows session where SAP GUI is already installed.

A note on transferring your system list

Our tool, SAP Logon Transfer, works with the Windows client's SAPUILandscape.xml. If you move between Windows machines it saves you a lot of retyping; on Mac, the Java client manages its own configuration separately.