Installation Guide

This installation guide describes the installation process for all supported platforms.

You will also find some hints on how RapidMiner can be started and how the installation can be further improved.

Installing RapidMiner (Windows)

On a Microsoft Windows system, you only have to download the executable installer file rapidminer-XXX-install.exe. After the download has finished, you should double-click on the downloaded file and follow the instructions of the setup dialog. After installation has finished you will find a new start menu entry and desktop icon for RapidMiner. Please note that there is no need for an extra Java installation.

Installing RapidMiner (any platform) Step 1: Installing Java

In order to use RapidMiner you need a Java Runtime Environment (JRE) version 7 or higher, which you can download from Oracle. Just download the correct version for your operating system (Windows, Mac, Linux, etc.) and install it on your system following the installation instructions for your Java package.

Installing RapidMiner (any platform) Step 2: Download and extract RapidMiner

You have to download the Zip archive containing RapidMiner for your system. This archive is called
In order to extract the downloaded RapidMiner archive you can use any file decompression tool available to you. In this example, we use WinRAR to unzip the archive into an arbitrarily chosen directory:
RapidMiner is now installed. Read below how to install additional extensions and how to start RapidMiner on your system.

Installing Extensions for RapidMiner

RapidMiner offers many extensions which are stored on the Marketplace. The easiest way to install a new extension from the Marketplace is “Updates and Extensions (Marketplace)…” from the “Help” menu of RapidMiner. You can search for new extensions or you can install the extensions you have bookmarked or purchased from the Marketplace (login required):

Starting RapidMiner: Windows

The next sections describe some hints how RapidMiner can be started and how the installation can be improved. Perform a click on the start menu entry or a double click on the desktop icon in order to start RapidMiner. Please note that RapidMiner automatically uses 90% of the free memory during startup. This should be ok for most applications. If you run into memory problems, you should check out one of the other possibilities to start RapidMiner and how to optimize memory usage.

Starting RapidMiner: Any Platform – Way 1

Two ways exist to start RapidMiner on any supported platform. The main reason why one should start RapidMiner with one of these ways is to adapt the amount of memory which is allowed for usage. The default Java installation uses only a small amount of memory (64 or 128 Mb) even if your system provides more physical memory (this is different for the Windows installation, see above). Therefore we recommend to define the maximum amount of memory which can be used by Java and the location of Java itself via the environment variables MAX_JAVA_MEMORY and JAVA_HOME:
In this example, we set the maximum amount of available memory to 800 Mb. JAVA_HOME was set to the installation path of Java. Afterwards you can double click on the start script RapidMinerGUI.bat in the scripts subdirectory of RapidMiner or invoke it from command line (please note that we also provide start scripts for Linux / Unix but it might be necessary to change the file settings with “chmod 750 RapidMinerGUI” or something similar). This will start the graphical user interface of RapidMiner:
Please note that increasing the maximum amount of memory via environment variables only works, if RapidMiner is started by using one of the start scripts. It does not affect the memory, if a start menu item or desktop icon were used on a Windows system.

Starting RapidMiner: Any Platform – Way 2

On some platforms it simply works to perform a double-click on the file lib/rapidminer.jar in order to start RapidMiner.

Starting RapidMiner: Any Platform – Way 3

Users familiar with Java might also want to start RapidMiner via the command line (now java -jar rapidminer.jar:
The maximum amount of memory can be specified via the -Xmx option of the Java Virtual Machine:
Please note that there is no empty space between the -Xmx option, the amount of memory (800 in this case), and the unit (m for Mb in this case).