Installation

Contents

• Linux
• macOS
• Windows
• SDKMAN

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:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

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 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 our tap.

Tap it via: brew tap sap/sapmachine

List available casks or versions of SapMachine to choose from: brew search sapmachine

Install a cask by name:
brew install --cask <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 install --cask sapmachine11-jre
brew install --cask sapmachine17-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.

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.

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