RubyMine 2018.3 Help

Install and set up RubyMine

Installation requirements

Hardware requirements

  • 2 GB RAM minimum, 4 GB RAM recommended

  • 1.5 GB hard disk space + at least 1 GB for caches

  • 1024x768 minimum screen resolution

Software requirements

JRE 1.8 is bundled with the RubyMine distribution. You do not need to install Java on your computer to run RubyMine.

Windows

macOS

Linux

32-bit or 64-bit versions of Microsoft Windows 10, 8, 7 (SP1), or Vista (SP2)

macOS 10.8.3 or later
(only 64-bit systems are supported)

  • OS Linux

  • KDE, Gnome or Unity desktop environment recommended

Download and install RubyMine

To install RubyMine

  1. Download RubyMine for your operating system.

  2. Do the following depending on your operating system:
    • Windows installation:
      1. Run the *.exe file you've downloaded.

      2. Follow the instructions in the installation wizard.

    • macOS installation:
      1. Open the .dmg package that you've downloaded, and drag RubyMine to the Applications folder.

    • Linux installation:
        1. Unpack the RubyMine-*.tar.gz file to a different folder, if your current Download folder doesn't support file execution:
          tar xfz RubyMine-*.tar.gz -C <new_archive_folder>

          The recommended installation location according to the filesystem hierarchy standard (FHS) is /opt. To install RubyMine into this directory, enter the following command:

          sudo tar xfz RubyMine-*.tar.gz -C /opt/
        2. Switch to the bin subdirectory:

          cd <new archive folder>/RubyMine-*/bin
          For example,
          cd /opt/RubyMine-*/bin

        3. Run rubymine.sh from the bin subdirectory.

    Earlier RubyMine versions are available for download on the Previous RubyMine Releases page.

    Run RubyMine for the first time

    Import RubyMine settings

    When you start RubyMine for the first time, or after you have upgraded it from a previous version, the Complete Installation dialog opens where you can select whether you want to import the IDE settings:

    rm installation importsettings

    If this is your first instance of RubyMine, choose the Do not import settings option.

    Selecting keymap scheme

    On the next page, RubyMine suggests to select the keymap scheme.

    rm installation keymap

    Select the user interface theme

    Next, you will be prompted to select the UI theme. You can choose between the Darcula and Light themes:

    rm installation theme

    Disable the unnecessary plugins

    RubyMine is shipped with a variety of plugins that provide integration with different version control systems and application servers, add support for various frameworks and development technologies, etc.

    On the next step you can disable the plugins you do not need to increase RubyMine performance. If necessary, you can re-enable them later in the Settings dialog ( Ctrl+Alt+S under Plugins).

    rm installation customizebasic

    You can click the Disable All link for each group of plugins to disable them all, or Customize to disable individual plugins.

    Download and install additional plugins

    On the next step, RubyMine prompts you to download and install additional plugins from the RubyMine plugins repository.

    rm installation customizeplugins

    Start a project in RubyMine

    After you have completed initial RubyMine configuration, the Welcome screen will be displayed. It allows you to:

    Welcome screen

    Register RubyMine

    To try and evaluate RubyMine, you can download and install its trial version for free. The trial version is available for 30 days, whereupon you need to obtain and register a license.

    1. Do one of the following:

      • On the Welcome screen, click Configure | Manage License

      • On the main menu, select Help | Register

      The License Activation dialog
    2. Select how you want to register RubyMine:

      Option

      Description

      JetBrains Account

      Register using the JetBrains Account.

      For more information, see What is JetBrains Account?

      Activation code

      Register using an activation code.

      License server

      Register using a License Server.

      To override the URL of the system proxy during initial RubyMine startup, use the -Djba.http.proxy property, which can be added as a JVM option.

      When performing silent install or managing RubyMine installations on multiple machines, you can set the JETBRAINS_LICENSE_SERVER environment variable to point the installation to the license server URL.

    If you have plugins that require a license, then instead of the License Activation dialog, open the Licenses dialog by clicking Help | Licenses from the main menu.

    The Licenses dialog

    The Licenses dialog contains a list of licenses and shows their states:

    • Expired: Renew your license to continue.

    • Grace period: You have several days until the license expires.

    • Evaluation period: Use without an active license.

    • Active license: Use until the expiry date.

    To configure a license, click the Edit button, which opens the License Activation dialog.

    Update RubyMine

    Out of the box, standalone RubyMine installation is configured to check for updates automatically. It will notify you when a new version is available(show you notification in the Events tool window):

    Platform and Plugin Updates

    RubyMine updates are usually patch-based: they are applied to the existing installation and only require you to restart the IDE.

    If the patch download takes a long time, you can send it to the background and continue working. Once download is complete, you will be prompted to restart, which should finalize the update.

    If you do not want to install the proposed update for some reason, you can ignore it by clicking the Ignore This Update button in the update dialog box. The ignored build's number will be added to the Ignored updates list, and you will not be prompted to install this particular build until you remove it from the list.

    Manage RubyMine through Toolbox App

    Toolbox App is a control panel that allows you to manage all JetBrains developer tools, including RubyMine, as well as your projects, from a single point of access. It lets you launch the IDEs, maintain different versions of the same tool, install updates and roll them back if needed. It also remembers your JetBrains Account and uses it to automatically log you in when you install and register new tools.

    1. Download Toolbox App.

    2. Launch the setup file.

    3. When the installation is complete, accept the JetBrains privacy policy and sign in to your JetBrains Account.

    Now you can manage existing tools, install new tools, and download updates:

    RubyMine in the Toolbox app

    Perform silent installation on Windows

    Silent installation is performed without any user interface. It can be used by network administrators to install RubyMine on a number of machines and avoid interrupting other users.

    To perform silent install, run the installer with the following switches:

    • /S: Enable silent install

    • /D: Specify the path to the installation directory

    • /CONFIG: Specify the path to the silent configuration file

    For example:

    RubyMine.exe /S /CONFIG=d:\temp\silent.config /D=d:\IDE\RubyMine

    Silent configuration file

    You can download the silent configuration file for RubyMine at https://download.jetbrains.com/ruby/silent.config

    The silent configuration file defines options for installing RubyMine. With default options, silent installation is performed only for the current user (mode=user). If you want to install RubyMine for all users, open the silent configuration file with a text editor, change the value of the installation mode option (mode=admin) and run the installer as an administrator.

    Uninstall RubyMine silently

    To silently uninstall RubyMine, run the uninstaller with the /S switch as an administrator. The uninstaller is located in the installation directory under bin.

    Run cmd (Windows Command Prompt) as administrator, change to the RubyMine installation directory, and run the following:

    bin\uninstall.exe /S

    Install RubyMine as a snap package on Linux

    You can install RubyMine on Linux as a self-contained snap package. Since snaps update automatically, your RubyMine installation will always be up-to-date.

    RubyMine is distributed via two channels:

    • The stable channel includes only stable versions. To install the latest stable release of RubyMine, run the following command:

      $ sudo snap install rubymine --classic
    • The edge channel includes EAP builds. To install the latest EAP build of RubyMine, run the following command:

      $ sudo snap install rubymine --classic --edge

    When the snap is installed, you can launch it by running the rubymine command.

    To list all installed snaps, run sudo snap list. For more information, see the Snapcraft documentation.

    Last modified: 10 January 2019

    See Also