Download and Installation of SapMachine

Contents

• Download of SapMachine
• Installation on Linux
• Installation on MacOS
• Installation on Windows
• Installation with SDKMAN

Download of SapMachine

SapMachine downloads for the latest versions can be found on sapmachine.io.

On the SapMachine GitHub repository you can also find older builds.

Stable links

We also provide stable links to the latest version of maintained and supported releases of SapMachine, following the schema https://sapmachine.io/latest/<major-version>/<os-name>-<cpu-architecture>/[jdk|jre] For example for SapMachine 25 you can download the latest version from sapmachine.io or sapmachine.io.

Find the link for any supported platform & version in the following table.

Installation on Linux

Debian or Ubuntu

On debian based Linux systems, e.g. Ubuntu, you can add the SapMachine debian package repository to the system’s repository list. With that you can install and update SapMachine via the the apt package manager. To accomplish this, you need to import the public key, add the repository, and update the package information. Then you can install the desired SapMachine release. E.g. run the following commands:

wget -qO- https://dist.sapmachine.io/debian/sapmachine.key > /etc/apt/trusted.gpg.d/sapmachine.asc
echo "deb https://dist.sapmachine.io/debian/$(dpkg --print-architecture)/ ./" > /etc/apt/sources.list.d/sapmachine.list
apt-get update
apt-get install sapmachine-25-jdk

Alpine

For managing SapMachine on Alpine Linux systems, we provide and apk package repository. To use it, import the public key, and add the repository to the system list. Afterwards install the desired SapMachine release. E.g. run the following commands:

wget -qO /etc/apk/keys/sapmachine-apk.rsa.pub https://dist.sapmachine.io/alpine/sapmachine-apk.rsa.pub
echo "https://dist.sapmachine.io/alpine" >> /etc/apk/repositories
apk add sapmachine-25-jdk

RPM

On RPM-based systems, e.g. Fedora, CentOS, or OpenSUSE, you can use .rpm packages.

Using yum

To use SapMachine RPM repositories with the yum package manager, import the public key and add the repository to the system list. Afterwards install the desired SapMachine release. E.g. run the following commands:

sudo rpm --import https://dist.sapmachine.io/rpm/sapmachine.key
sudo curl -L -o /etc/yum.repos.d/sapmachine.repo https://dist.sapmachine.io/rpm/sapmachine.repo
sudo yum install -y sapmachine-25-jdk

Using zypper

To install and update SapMachine with the zypper package manager, you need to add the SapMachine RPM repository to the system repository list. For compatibility reasons, a different repo URL needs to be used for SUSE installations. After running zypper refresh you can install the desired SapMachine release. E.g. run the following commands:

sudo zypper addrepo https://dist.sapmachine.io/rpm/sapmachine.repo
# or for SUSE:
# sudo zypper addrepo https://dist.sapmachine.io/rpm/sapmachine-suse.repo
sudo zypper refresh
sudo zypper install sapmachine-25-jdk

Direct download

It is also possible, to download a SapMachine binary archive to an arbitrary location in the file system. To use it, set environment variable JAVA_HOME to the root directory of the extracted archive (e.g. /<...>/sapmachine-jdk-25.0.1) and add $JAVA_HOME/bin to the environment variable PATH.

Installation on MacOS

SapMachine Manager

A very convenient way to install SapMachine versions and keep them up to date is to use the SapMachine Manager. Install it from GitHub, then install the SapMachine version you need (default is the latest LTS) and SapMachine Manager will keep it up to date for you from there on. You can as well opt out from the autoupdate.

Homebrew

The package manager Homebrew is another way to manage SapMachine installations on MacOS. To install Homebrew, follow the instructions on its homepage.

Then, to install the latest SapMachine do:

brew update
brew install sapmachine-jdk

To install other versions of SapMachine you can use our tap:

brew tap sap/sapmachine
brew install sapmachine25-jdk

Available casks

Examples:

brew install --cask sapmachine21-jre
brew install --cask sapmachine25-jdk
brew install --cask sapmachine26-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-25.0.1) and PATH (i.e. $JAVA_HOME/bin) environment variables.

Installation on Windows

SapMachine installer packages (e.g. *.msi files) is the simplest way to install SapMachine on Windows.

Alternatively, you can download a SapMachine zip archive and unpack it to an arbitrary location in the file system. Then add the System variable JAVA_HOME and set it to the root directory of the extracted archive (e.g. C:\<...>\sapmachine-jdk-25.0.1). 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!, a platform independent package manager, supports SapMachine as well. Because of the current length limit in the SDKMAN! version string, SapMachine has to be abbreviated as sapmchn. Installing it with SDKMAN! is as simple as:

### install SapMachine17
sdk install java 17.0.17-sapmchn
### install SapMachine21
sdk install java 21.0.9-sapmchn
### install SapMachine25
sdk install java 25.0.1-sapmchn