You are viewing the RapidMiner Studio documentation for version 9.9 - Check here for latest version

Installing RapidMiner Studio

Welcome to RapidMiner Studio, the easy-to-use visual environment for predictive analytics. With these simple instructions, in five minutes you will be building models and making predictions. No programming required.

You may want to verify that your system meets the system requirements before beginning the installation.

Downloading RapidMiner Studio

Follow these instructions to download RapidMiner Studio:

  1. To download the application, go to the RapidMiner RapidMiner website.

  2. Click the Download button in the upper right corner.

  3. Log in if you haven't already. See below if you need to create an account. If you just want to download RapidMiner Studio without logging in, click on Downloads.

  4. Click on your preferred operating system to begin the download. Your current operating system will be highlighted.

While you do not need to create an account to download software, complete the registration and click Sign up to experience the benefits of the RapidMiner community. Note that the password must be a minimum of six characters.

Immediately, the system sends an activation email to the address that you registered. (Allow email from RapidMiner if you do not see an email titled “Verify Your Email” in your inbox.)

Click confirm your email address to activate your account. You receive a message that account creation was successful (and the system logs you in):

If you have already downloaded RapidMiner Studio, click the close. Otherwise, click the link to download.

Installing RapidMiner Studio

When the download completes, install the software following the instructions appropriate to your platform. If you are upgrading RapidMiner Studio, make sure to quit the application before trying to install a new version.

Running the installation

Follow these simple instructions to run the launcher that installs RapidMiner Studio on Windows.

  1. Double-click the downloaded file (for example, rapidminer-studio-<version>-win64-install.exe).

  2. If prompted, allow the program to make changes to your computer. The RapidMiner Studio Setup Wizard appears. Click Next to continue.

  3. Read the terms of the license agreement and click I Agree to continue.

  4. Select a destination folder (or leave the default). Please ensure that the folder path does not contain + or % characters. By clicking Install, the wizard extracts and installs RapidMiner Studio. When the installation completes, click Next and then Finish to close the wizard and start RapidMiner Studio.

  5. Read the terms of the license agreement and click I Accept to continue.

Running the installation

To successfully install RapidMiner Studio on a Macintosh system, ensure that you are running Mac OS 10.10 or later. Then, follow these simple instructions:

  1. Double-click the downloaded file (rapidminer-studio-osx-<version>.dmg).

  2. Drag RapidMiner to your Applications folder. If prompted to replace an older edition, select Replace.

  3. Starting the app depends on the OS X version:
    • (OS X 10.10 - 10.14): Double-click the App.

    • (OS X 10.15): Unfortunately you will right now see the image below when double-clicking. Instead, you need to right-click the app and select Open. Note that depending on your precise OS X version, you may even have to repeat the right-click step to get the Open action to work correctly! This happens due to the fact that we distribute Java 8 with RapidMiner Studio, which cannot be notarized at this point in time.

  4. Read the terms of the license agreement and click I Accept to continue. RapidMiner Studio opens.

Linux prerequisites

The RapidMiner Studio installation package for Linux does not include a Java Runtime Environment. Before installing RapidMiner Studio, use the package manager of your distribution to install a version 8 JRE (unless it is already present with your operating system) and verify that the JAVA_HOME variable points to it or java (contained in the bin folder of your Java installation) is on the PATH.

Running the installation

Follow these simple instructions to install RapidMiner Studio on a Linux system:

  1. Double-click the downloaded zip file (for example, rapidminer-studio-<version>.zip). The extracted folder contains script files for different operating systems. Please ensure that the folder path does not contain + or % characters.

  2. Open a terminal window and run ./ from the directory containing the download.

  3. Read the terms of the license agreement and click I Accept to continue. RapidMiner Studio opens.

Getting started with RapidMiner Studio

Once you launch RapidMiner Studio, and you have accepted the EULA, a Welcome screen appears, prompting you to login with your RapidMiner Account:

Option Description
Login and Install You can enter your existing RapidMiner account credentials in the username/password fields, and download your license immediately.
Create a new RapidMiner account If you do not yet have a RapidMiner account, a new browser window will open in which you can create it.
Manually enter a license key If you do not have access to the Internet, you can install a license key manually here.

Once logged in, if you have purchased a license, the system installs it based on your credentials.

RapidMiner Studio login

If you have already created a RapidMiner account, you can log in straight away:

Enter your email address and password to login with your account and then click Login and Install.

Note: Once installed, you can also add or update licenses using the Settings > Manage Licenses menu within the RapidMiner Studio application.

If you cannot access your account (for example, if RapidMiner is blocked by a firewall), your license cannot be automatically loaded.

If this is the case, you can enter your license manually by clicking on the Enter a license key link.

Create RapidMiner account

Creating an account requires access to the Internet: RapidMinerCreate account

  1. Complete the steps to create an account by following the instructions on screen.

  2. Once you are done, you can return to RapidMiner Studio and enter your credentials to proceed.

To enter a license key manually, you must first copy the key to your clipboard. The key is available from the Licenses page of your account portal.

  1. Click the Licenses option from your account portal. When the page opens, make sure the Studio tab is selected. Your license information, including license type and expiration, displays:

  2. Click View License Key next to the appropriate license to display the key.

  3. Click in the box containing the key to select it, then copy it to your clipboard.

  4. Return to the RapidMiner Studio login screen and click the Enter a license link.

  5. Paste your license key into the box. Note that the right-hand portion of the window populates with license information, including the edition and expiration.

  6. Click Install.

From the login screen you can also Reset Credentials. Clicking the link opens the account page. From there, you can change your email or password.

Once you click Login and Install, the Success screen appears. Click I'm ready.

Go be a hero! If this is your first time installing RapidMiner Studio, we recommend that you start with displayed Tutorial to learn just how easy code-free can be. Happy mining!

More You Should Know

Just a few more tidbits relating to RapidMiner Studio...

Using the RapidMiner Marketplace

The RapidMiner Marketplace is your one-stop site to download and share extensions for RapidMiner Studio. Follow these steps for detailed instructions on accessing and using the RapidMiner Marketplace, or take a look at Marketplace here.

Moving the start script

By default, the RAPIDMINER_HOME variable is set to the folder location of the start script. If you leave the script within the installation folder (the most common method), the environment variable is set correctly. If you move the start script out of the installation folder, you must set the environment variable RAPIDMINER_HOME to the installation path of RapidMiner Studio. This allows RapidMiner to find its resource files.

Uninstalling or re-installing RapidMiner Studio

At the first running of RapidMiner Studio, the software creates a .RapidMiner folder in your user home directory. RapidMiner Studio stores your personal settings and data (e.g., database connections) in this folder. If you ever need to completely remove RapidMiner or to discard all personal settings, simply delete this directory. Do not remove the directory if your RapidMiner Studio installation is damaged and you want to re-install it. By maintaining the .RapidMiner directory, your personal data will be kept in tact for the new installation.

Starting with RapidMiner Studio 9.8 the storage for newly created local repositories and collaborative projects from RapidMiner AI Hub are created in your local users Documents/RapidMiner/ folder. To remove or backup all the data from repositories, remove or backup this folder, too.

To delete the .RapidMiner directory off of a Mac:

  1. Open Finder and from the pull-down menus select Go > Go to Folder. (Alternatively, use the keyboard shortcut Key shortcut.)

  2. In the resulting dialog, enter ~/.RapidMiner/ and click Go.

  3. From the pull-down menus, select View > as Columns to select the columns view. (Alternatively, use the keyboard shortcut Key shortcut.) The .RapidMiner folder is highlighted.

  4. Delete the folder (Move to Trash).