RubyMine 2016.2 Help

Tuning RubyMine

In this part:

Changing RubyMine properties

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

To create an empty idea.properties file or to copy *.vmoptions file, choose the Help | Edit Custom Properties or Help | Edit Custom VM Options on the main menu respectively. Refer to the menu items description for details.

Managing *.vmoptions file

The location of the *.vmoptions file depends on the operating system you are currently using:

  • For Windows systems: <RubyMine installation folder>/bin/rubymine.vmoptions or <RubyMine installation folder>/bin/rubymine64.vmoptions
  • For *NIX systems: <RubyMine installation folder>/bin/rubymine.vmoptions or <RubyMine installation folder>/bin/rubymine64.vmoptions
  • For OS X systems, you have to make a copy of the rubymine.vmoptions file in the IDE preferences folder and then edit this copy. The reason is that app bundle is signed and you should not modify any files inside the bundle.
    The file /Applications/RubyMine XX.app/Contents/bin/rubymine.vmoptions should be copied to ~/Library/Preferences/RubyMine XX/rubymine.vmoptions

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

To avoid editing files in the RubyMine installation folder, one should:

  1. Do one of the following:
    • Use the main menu command Help | Edit Custom VM Options to create a copy of the rubymine.vmoptions file in the user home. Refer to Edit Custom VM Options for details.
    • Copy the existing file from the RubyMine installation folder somewhere and save the path to this location in the environment variable RUBYMINE_VM_OPTIONS.
    • Copy the existing file <RubyMine installation folder>/bin/rubymine$BITS.vmoptions from the RubyMine installation folder into the location under user home.
  2. Edit this file in the new location.

If RUBYMINE_VM_OPTIONS environment variable is defined, or the *.vmoptions file exists, then 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 IDEA.properties file

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

So, depending on your platform:

  • For Windows: in %USERPROFILE%\.RubyMine XX
  • For *NIX: in ~/.RubyMine XX
  • For OS X: in ~/Library/Preferences/RubyMine XX

Example: Changing case of unicode literals

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

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

If it is desirable to use lower case characters, create the file idea.properties in the location specified above, open it for editing and add the following line:

idea.native2ascii.lowercase=true

Specifying custom JDK, properties or vmoptions files across platforms

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

All the launchers look at the following environment variables:

  • $<IDE-NAME>_JDK (<IDE-NAME>_JDK_64)
  • $<IDE-NAME>_PROPERTIES
  • $<IDE-NAME>_VM_OPTIONS

See Also

Last modified: 21 July 2016