Basics and Installation
On this page:
- Downloading and installing RubyMine
- Starting RubyMine on the various platforms
- Importing RubyMine usage preferences from a previous version
Downloading and installing RubyMine
You can download the latest version of RubyMine from the JetBrains website. (There are the versions for Windows, OS X and Linux.)
Depending on your operating system:
- Windows: Run the
.exefile and follow the instructions of RubyMine Setup wizard.
- OS X: Open
- Linux: Unpack the
.tar.gzarchive into any directory within your home directory.
Refer to the section Starting RubyMine on the various platforms for details.
Starting RubyMine on the various platforms
Starting RubyMine on Windows
If during the installation you selected to create a shortcut on your desktop, double-click that shortcut.
Otherwise, go to the
C:\Program Files (x86)\JetBrains\IntelliJ IDEA 14.0.2\bin) and
Starting RubyMine on OS X
Make sure that you have an appropriate version of Java (JRE or JDK) installed.
This may be Java 6 from Apple, or Java 7 or a later version from Oracle.
(You can try to start RubyMine right away. If there is no Java on your computer, RubyMine will notify you about that.)
If you are using Java 7 or 8:
Copy the file
JVMVersion=1.7*if you are using Java 7 or to
JVMVersion=1.8*if you are using Java 8.
- Save and close the file.
- Copy the file
Go to your
/Applicationsfolder and run the RubyMine application.
Starting RubyMine on Linux
Before you start
Make sure that you have an Oracle JRE or JDK version 6 or later installed on your computer. Refer to the section Installing Oracle JDK.
To launch RubyMine on Linux, follow these steps:
RubyMine-*.tar.gzfile from the Download page.
RubyMine-*.tar.gzfile using the following command:
tar xfz RubyMine-*.tar.gz
Because running RubyMine from wherever you downloaded the file to may be inconvenient, it is recommended that you
move the extracted or unpacked archive folder to the desired location using the
mvcommand in one of the following formats:
mv <path to extracted archive folder> <new archive folder>
mv /downloads/RubyMine-* my/desired/location
mv <path to RubyMine-*.tar.gz> <new archive folder>
mv /downloads/RubyMine-*.tar.gz my/desired/location
Switch to the
bindirectory in the new location:For example,
cd <new archive folder>/RubyMine-*/bin
- Install Oracle (Sun) JDK 1.6 or higher if your distribution does not contain it.
Follow the provider's instructions at http://www.oracle.com/technetwork/java/javase/downloads/index.html.
Installing Oracle JDK
To install Oracle (Sun) JDK, do one of the following
Use the Debian repository. In the Command prompt, type the following sequence of commands:
sudo add-apt-repository "deb http://archive.canonical.com/ lucid partner"
sudo apt-get update
sudo apt-get install sun-java6-jdk sun-java6-jre sun-java6-plugin
java -versionto check that installation is successful.
- Download and install JDK from Oracle official site.
Additionally, you can create a desktop shortcut and a command-line launcher, and use them to start RubyMine:
Creating a desktop shortcut
To create a desktop shortcut for RubyMine, use the Create Desktop Entry command. This command is available:
- In the Customize RubyMine wizard - when you run RubyMine for the first time.
- On the Welcome screen: .
- In the main menu: .
You can choose to create the shortcut:
For all of your computer users:
In this case, the
jetbrains-idea.desktopentry file is created in
Only for yourself:
jetbrains-idea.desktopentry file is created in
RubyMine provides several types of licenses, to flexibly meet the demands of the customers. In particular, there are such licences as:
- Personal (for individual developers)
- Commercial (for companies and organizations)
- Students (for students and teachers)
- Classroom (for education and training)
- Open-source (for open-source projects)
Besides that, RubyMine provides additional licensing options.
Find the detailed information about licensing terms and additional options on the Buy & Renew page.
Registering your license key
To register your license key
- On the main menu, choose . Note that menu action is not available for EAP builds.
- In the RubyMine License Activation dialog box, select the desired option:
- Enter license key: specify the user name and license key.
- Enter license server address: specify the license server. If you don't know the address, click Discover.
- JetBrains Account: specify the user name or e-mail address and enter the password.
- Evaluate for free for 30 days: select this option to get free evaluation license.
- Click OK.
License tickets from the License Server
If you are using a license distributed with the JetBrains License Server, you can get two types of license tickets. By default, the server issues a floating license ticket for you, which lasts as long as you are connected to the server. If you need to work offline, you can get a permanent license ticket.
The table below describes the differences between the two types of the license tickets.
|Floating license ticket(default)||At startup, RubyMine finds the License server in the local network and requests a ticket, which is returned to the server and becomes available to other users when RubyMine is closed. Both obtaining and returning of the ticket are done automatically.||Number of licenses on the license server can be less than the number of RubyMine users. For example, if there are 60 engineers who use RubyMine but only a maximum of 50 of them can use RubyMine concurrently, then 50 licenses on the license server would be enough.||Connection to the License Server via a local network or VPN is required to start RubyMine.|
|Permanent license ticket||Once obtained, a permanent ticket stays on a client machine. It is not available to other users until it is returned from the client. Both obtaining and returning of the ticket are done manually on the client or by a license server administrator.||The client do not need network connection to start RubyMine.||The license obtained with a permanent ticket remains unavailable for other users even if the client do not use it.|
Getting a permanent license ticket
To get a permanent license ticket
You need a permanent license ticket to be able to work with RubyMine offline (or outside the local network) with a license from the License Server. After specifying the license server address, the command appears on the menu.
- On the main menu, choose .
- In the dialog box that opens, type your email address, to which your activation key will be sent.
- Click OK.
As soon as the permanent license ticket is successfully obtained, you can return it back to the server with the command that appears in the menu.
A license key can be rejected by the software in certain cases. The table below outlines the reasons of license rejections, and the possible ways to solve the problem.
|Wrong user name||Make sure that you are using the User Name which is specified in your license certificate email. If a license is registered in your company name, it will not work with your personal name.|
|Misspelled User Name/License Key||To avoid misspellings, we recommend that you copy your User Name and license key from the license certificate e-mail rather than enter them manually in the software. You can do so by using the Ctrl+C and Ctrl+V shortcuts.|
|A license key does not qualify for upgrade to a higher version||If your license key does not work with the newly installed version of the software, please make sure that your current license key allows you to upgrade for free to the latest version. If it does not, please contact sales (firstname.lastname@example.org) in order to upgrade your license.|
|Concurrent use of a license key||Make sure that your license key is not being used by another developer in your company at the same time. Concurrent use of a single license on multiple instances of the software is restricted by our software license agreements (unless you have obtained a floating license) and is prevented by software functionality.|
Importing RubyMine usage preferences from a previous version
To make your transition to a newer version unnoticeable, RubyMine lets you import your usage preferences from its previous installation.
When you start RubyMine for the first time, the Complete Installation dialog opens, and you can import your usage preferences from the previous version of RubyMine by selecting one of the following options:
- I want to import my settings from a previous version (<path>). If this option is present in the dialog, the directory that contains the RubyMine settings is found at its default location. (The corresponding path is shown within the option name in parentheses.) Most likely, this is the option that you want.
- I want to import my settings from a custom location. You may have the directory with the settings available but not at its default location. To import the settings in this case, you can specify the folder with the settings (if you know where it is) , or an installation folder of the previous RubyMine version. To do that, click and select the folder in the dialog that opens .
See also, Exporting and Importing Settings.