RubyMine 2017.2 Help

Tuning RubyMine

In this part:

Changing RubyMine properties

RubyMine makes it possible to change the *.vmoptions and the files without editing them in the RubyMine installation folder.

To create an empty file or to copy the *.vmoptions file, choose Help | Edit Custom Properties... or Help | Edit Custom VM Options... from the main menu respectively.

Managing the *.vmoptions file

The location of the *.vmoptions file depends on your operating system:

  • For Windows: <RubyMine installation folder>/bin/rubymine.exe.vmoptions or <RubyMine installation folder>/bin/rubymine64.exe.vmoptions
  • For *NIX: <RubyMine installation folder>/bin/rubymine.vmoptions or <RubyMine installation folder>/bin/rubymine64.vmoptions
  • For macOS, you need to make a copy of the rubymine.vmoptions file in the IDE preferences folder and then edit this copy. The reason is that the app bundle is signed and you should not modify any files inside the bundle.

    For older versions, the settings are stored in /Applications/RubyMine <version>.app/Contents/Info.plist.

To avoid editing files in the RubyMine installation folder, do one of the following:

  • From the main menu, choose Help | Edit Custom VM Options to create a copy of the rubymine.vmoptions file in the user home directory.
  • Copy the existing file from the RubyMine installation folder somewhere and save the path to this location in the RUBYMINE_VM_OPTIONS environment variable (IDEA64_VM_OPTIONS for 64 bit systems).
  • Copy the existing <RubyMine installation folder>/bin/rubymine.exe.vmoptions or the <RubyMine installation folder>/bin/rubymine64.exe.vmoptions file from the RubyMine installation folder into your user home directory.

Then edit this file in the new location.

If the RUBYMINE_VM_OPTIONS environment variable is defined, or the *.vmoptions file exists, this file is used instead of the one located in the RubyMine installation folder.

Example: Increasing the heap size

To increase RubyMine heap size, you should copy the original rubymine.vmoptions file to the above-mentioned location, and then modify the -Xmx setting.

Managing the file

The file located in the bin directory of the RubyMine installation folder should not be edited. Instead of editing the original file, create an file in the following location, open it for editing and add the required properties:

  • For Windows: %\USERPROFILE%\\.RubyMineXXXX.X\config
  • For *NIX: ~/.RubyMineXXXX.X/config
  • For macOS: ~/Library/Preferences/RubyMineXXXX.X/config

To open the file in the editor, choose Help | Edit Custom Properties. If the file does not exist yet, RubyMine creates it and opens in the editor.

Example: Changing the case of unicode literals

RubyMine allows defining whether non-ascii characters should use literals like '\u00AB' or '\00ab'.

This behavior is controlled by the idea.native2ascii.lowercase system property. By default, upper-case characters are used.

If you wish to use lower-case characters, create the file in the location specified above, open it for editing and add the following line:


Specifying custom JDK, properties, or vmoptions files across platforms

A custom JDK, as well as *.properties and *.vmoptions files are specified across platforms in a unified way.

All launchers look at the following environment variables:

Last modified: 26 October 2017

See Also