RubyMine 2026.3 Help

WSL

WSL (WSL 2) – Windows Subsystem for Linux – is a compatibility layer for running Linux binary executables natively on Windows 10 and later. Currently, it supports several Linux distributions, such as Ubuntu, OpenSUSE, and SLES.

Native mode

Starting with version 2026.3, RubyMine opens projects stored in the WSL file system in Native mode. To work with such a project, open it in RubyMine running on Windows, and use native WSL interpreters to run Ruby.

In Native mode, RubyMine runs on your local machine and works with a project stored in WSL or in a Dev Container directly. Your code, Ruby installation, gems, and tools stay in the Linux environment. A lightweight agent in the environment handles file access and process execution.

Compared with Remote Development, Native mode works as follows:

  • RubyMine does not download or install an IDE backend in the environment.

  • The project opens in a regular RubyMine window instead of a separate client. Your local settings, plugins, and keymap apply as usual.

  • Linux paths and symbolic links are handled correctly, without converting them to Windows paths.

Compared with legacy remote interpreters, native interpreters do not require path mappings and do not copy helper scripts to the environment. RubyMine runs Ruby, Bundler, tests, and other tools directly in the environment.

Remote Development remains the recommended option when your project is located on a remote machine that you connect to over SSH.

Enable the Remote Execution Agent plugin

Make sure this plugin is installed and enabled to ensure the proper performance of your IDE.

  1. In the Settings dialog (Ctrl+Alt+S) , select Plugins.

  2. Start typing the name of the plugin.

  3. Do one of the following:

    • If the plugin is not installed, click Install. Wait for RubyMine to install the plugin and make sure it is enabled. If not, click Enable.

    • If the plugin is installed, find the plugin and make sure it is enabled. If not, click Enable.

    The image below shows the plugin in the enabled state.

    Remote Execution Agent plugin
  4. Apply the changes and close the settings dialog.

Configure WSL

  1. Download and install a WSL distribution (for instance, Ubuntu) from Microsoft Store on your Windows machine.

    For this step, be sure to use at least Windows 10 or later with the latest “Fall Creators Update” (minimum version 1709, build 16299.15). See the official guide Install the Windows Subsystem for Linux for instructions.

    To work with WSL 2, your Windows version should be 10 build 18917 or later. Follow these instructions to switch the distributive.

  2. Run the Linux distribution.

    Upon the first launch, the system may prompt you to enable the Windows optional feature. In this case, you need to do the following:

    • Open Windows PowerShell as Administrator and run

      Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
    • Restart your computer.

  3. (Optional) If your Linux distribution doesn't come with rsync, you need to install it, for example:

    apt-get install rsync
    yum install rsync

You can create a project and store it in the WSL environment, open one from the WSL file system, and develop your projects further in WSL.

Create a new project in the WSL file system

  1. Install and run RubyMine locally on Windows as you normally would.

  2. On the Welcome screen, click New Project or select File | New Project from the main menu.

    Create a project in WSL: Welcome screen
  3. On the page that opens, select the project type and provide details for the following fields:

    1. Name: project name

    2. Project location: the location of your project on WSL. You can enter or paste the path directly, or click the Browse button to find the directory using the file browser.

      The syntax of the path to a project is as follows:

      \\wsl.localhost\DistributionName\home\UserName\ProjectName

      DistributionName is the name of the Linux distribution, UserName is the name of your user directory.

      Check the following example: \\wsl.localhost\Ubuntu\home\test\MyProject.

    3. Interpreter: the Ruby interpreter or the version manager executable installed in WSL.

    4. Rails version (If a Rails application type was selected): select a Rails version that you want to use in your project. If the Rails gem is not installed in the selected interpreter or the necessary Rails version is missing, click the + icon in the field. Wait until RubyMine downloads all available Rails versions and select the necessary version from the dropdown. Click OK to continue.

  4. Click Create.

    Select project location in WSL

    RubyMine creates a project located in WSL, and you can develop and build your project inside the WSL environment without leaving the IDE.

Open a project stored in the WSL file system

In RubyMine, you can directly open a project stored in the WSL file system and work with it like with any other project.

  1. Click Open on the Welcome screen or select File | Open from the main menu.

  2. In the dialog that opens, specify the project location: either insert the path to the folder in the WSL file system or locate it using the file browser.

    The path syntax is \\wsl.localhost\DistributionName where DistributionName is the name of your Linux distribution such as Ubuntu, Debian, Arch, and so on.

    open existing project in wsl
  3. Click OK. RubyMine opens the project in Native mode.

    If this is the first WSL project that you open and you do not have legacy WSL interpreters, RubyMine enables native WSL interpreters and detects Ruby installed in WSL. Otherwise, you can switch to native interpreters on the Ruby settings page.

Configure the project location

You can ensure that any project you create or open uses the appropriate WSL location.

  1. Press Ctrl+Alt+S to open settings and then select Appearance & Behavior | System Settings.

  2. Under the Project section, in the Default project directory field, specify the appropriate WSL directory and click OK to save the changes.

    Default project directory

    From now on, whenever you create, open, or clone a project, the specified directory is selected by default.

WSLg

WSLg lets you run Linux GUI applications and shows their output on the Windows desktop.

We do not recommend running RubyMine through WSLg. RubyMine already provides native WSL integration, which is the preferred approach.

Keep in mind the following:

  • WSLg has limitations related to rendering, popups, window management, input methods, and desktop integration.

  • We do not provide dedicated support, installation guidance, onboarding, or product-specific fixes for running RubyMine through WSLg.

To learn how to open a project, refer to Open a project stored in the WSL file system or if you want to create the new one, refer to Create a new project in the WSL file system.

10 November 2026