Installation

Linux

• Download the archive and unpack it to an arbitrary location in the file system
• Set environment variable JAVA_HOME to the root directory of the extracted archive (e.g. /<...>/sapmachine-jdk-11.0.3)
• Add $JAVA_HOME/bin to the environment variable PATH

You might want to use our .deb packages if you're on Debian or Ubuntu:

sudo bash

apt-get install -y --no-install-recommends wget ca-certificates gnupg2

export GNUPGHOME="$(mktemp -d)"
wget -q -O - https://dist.sapmachine.io/debian/sapmachine.old.key | gpg --batch --import
gpg --batch --export --armor 'DA4C 00C1 BDB1 3763 8608 4E20 C7EB 4578 740A EEA2' > /etc/apt/trusted.gpg.d/sapmachine.old.gpg.asc
wget -q -O - https://dist.sapmachine.io/debian/sapmachine.key | gpg --batch --import
gpg --batch --export --armor 'CACB 9FE0 9150 307D 1D22 D829 6275 4C3B 3ABC FE23' > /etc/apt/trusted.gpg.d/sapmachine.gpg.asc
gpgconf --kill all && rm -rf "$GNUPGHOME"
echo "deb http://dist.sapmachine.io/debian/amd64/ ./" > /etc/apt/sources.list.d/sapmachine.list

apt-get update
apt-get install sapmachine-11-jdk

On RPM based systems you can use our .rpm packages.

Fedora:

sudo bash

dnf -y install ca-certificates curl

curl -L -O https://github.com/SAP/SapMachine/releases/download/sapmachine-11.0.4/sapmachine-jdk-11.0.4-1.x86_64.rpm

dnf -y install sapmachine-jdk-11.0.4-1.x86_64.rpm

CentOS:

sudo bash

yum -y install ca-certificates curl

curl -L -O https://github.com/SAP/SapMachine/releases/download/sapmachine-11.0.4/sapmachine-jdk-11.0.4-1.x86_64.rpm

yum -y install sapmachine-jdk-11.0.4-1.x86_64.rpm

OpenSUSE:

sudo bash

zypper -n install ca-certificates curl

curl -L -O https://github.com/SAP/SapMachine/releases/download/sapmachine-11.0.4/sapmachine-jdk-11.0.4-1.x86_64.rpm

zypper -n --no-gpg-checks install ./sapmachine-jdk-11.0.4-1.x86_64.rpm

---

macOS

Homebrew

Using Homebrew is the simplest way to install SapMachine. HomeBrew is a package manager for Mac. You can use it to manage your SapMachine installations.

At first, if you have not already done it, install homebrew:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

In case you did not just install it, you should update its contents:
brew update

HomeBrew supports the installation of the latest released SapMachine by default:
brew cask install sapmachine-jdk

However, you might want to install other versions, such as early access builds of releases/updates currently in development or older versions of a certain Java release, e.g. SapMachine 11 LTS. For this you can use this tap.

Tap it via:
brew tap sap/sapmachine

Then you can install SapMachines, picking a cask from the list below:
brew cask install <cask>

Available casks

Version	JDK	JRE
SapMachine Early Access	sapmachine<MAJOR>-ea-jdk	sapmachine<MAJOR>-ea-jre
SapMachine Released	sapmachine<MAJOR>-jdk	sapmachine<MAJOR>-jre

Example:

brew cask install sapmachine11-jdk
brew cask install sapmachine13-ea-jdk

Direct download

Alternatively, you can download and unpack (double-click in finder) the SapMachine archive for macOS to an arbitrary location in the file system. You may want to move the resulting directory to /Library/Java/JavaVirtualMachines (admin privileges required). If you do so, /usr/libexec/java_home -V will show SapMachine. Moreover, if SapMachine is the most recent JDK, the java command in the shell will use it. You can try this with java -version.

If you prefer not to have SapMachine integrated in macOS' Java Framework, make sure to set JAVA_HOME to the root directory of the extracted archive (e.g. /<...>/sapmachine-jdk-11.0.3) and PATH (i.e. $JAVA_HOME/bin) environment variables.

macOS 10.15 (Catalina)

If you install software downloaded from a website (not from the Apple App Store) on the new macOS 10.15 Catalina, you may run in the problem that it will be blocked:

Apple has sharpened the protection against malicious components (link). The notarizing process is ongoing, so here we inform you about an applicable workaround.

Downloaded SapMachine

After you downloaded something like "sapmachine-jdk-11.0.5_osx-x86_bin.dmg" from https://sap.github.io/SapMachine, open a terminal goto download directory and enter

find . -iname sapmachine-jdk-11.0.5_osx-x86_bin.dmg -print0 | xargs -0 xattr -d com.apple.quarantine

This removes the com.apple.quarantine extended attribute. More about this you find here (link). You can check if this was successful with xattr sapmachine-jdk-11.0.5_osx-x86_bin.dmg. This should not list the following line: com.apple.quarantine

Installation with homebrew

You do not will get the blocking when installing with homewbrew (link).

Installations done before the upgrade to macOS 10.15

These JDK installations will not be blocked, too.

---

Windows

Using the Windows Installer (download the MSI package) is the simplest way to install SapMachine on Windows.

Alternatively, you can:

• Download the zip archive and unpack it to an arbitrary location in the file system
• Add the System variable JAVA_HOME and set it to the root directory of the extracted archive (e.g. C:\<...>\sapmachine-jdk-11.0.3)
• Edit the System variable PATH and add %JAVA_HOME%\bin to the PATHvariable separated from the previous path by a semicolon.

---

Installation with SDKMAN!

SDKMAN! now supports SapMachine. Because of the current length limit in the SDKMAN! version string, SapMachine has to be abbreviated as sapmchn. Installing with SDKMAN! is as simple as:

sdk install java 11.0.3-sapmchn