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

You do not need to have an account to download RapidMiner Studio. Creating an account, however, makes you a member of the RapidMiner community, which provides several significant benefits:

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 and joining the community, 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) and click Install. The wizard extracts and installs RapidMiner Studio. When the installation completes, click Next and then Finish to close the wizard.

  5. Open RapidMiner Studio using the shortcut in the Start menu or the desktop icon (both created during installation).

  6. 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.8 or later. Then, follow these simple instructions:

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

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

  3. 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 7 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.

  2. Open a terminal window and run ./RapidMiner-Studio.sh 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, a Welcome screen appears, prompting with three options:

Option Description
Join the RapidMiner Community Opens the registration page, allowing you to create an account and enjoy full community benefits.
Login If you previously registered, enter your rapidminer.com credentials to login so that you can download and install your license(s).
Continue without logging in Opens RapidMiner Studio Basic edition with limited functionality.

Once logged in, if you have purchased a license, the system installs it based on your credentials. If you have not purchased a license, the system installs a 14-day trial of RapidMiner Studio Professional. (On expiration, the trial license is replaced by a free RapidMiner Studio Basic license that does not expire.)

Join the RapidMiner community

If you chose to join the RapidMiner community on the Welcome screen, the sign-up screen appears:

Note: Joining the RapidMiner Community requires that RapidMiner Studio can access the Internet. If you do not have an Internet connection for the application (for example, if prevented by a firewall), join the community through your browser and enter your license key manually.

  1. Complete the steps to create an account by entering your email address and password. Note that the password must be a minimum of six characters.

  2. 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.) Periodic checks verify whether your email has been validated.

  3. Once you validate, you'll receive a success message in your browser:

  4. Return to the RapidMiner Studio application. Complete the installation and begin your 14-day trial of the RapidMiner Studio Professional by clicking Finish.

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

RapidMiner Studio login

If you have already registered with the RapidMiner community, clicking Login on the Welcome screen brings up the login screen:

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

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

If you cannot access your rapidminer.com 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.

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, indicating your license type and expiration date. Click Finish.

Go be a hero! If this is your first time installing RapidMiner Studio, we recommend that you start with the built-in Tutorials 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.

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).