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.
In the Settings dialog (Ctrl+Alt+S) , select Plugins.
Start typing the name of the plugin.
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.

Apply the changes and close the settings dialog.
Configure WSL
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.
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-LinuxRestart your computer.
(Optional) If your Linux distribution doesn't come with
rsync, you need to install it, for example:apt-get install rsyncyum 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
Install and run RubyMine locally on Windows as you normally would.
On the Welcome screen, click New Project or select from the main menu.

On the page that opens, select the project type and provide details for the following fields:
Name: project name
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\ProjectNameDistributionNameis the name of the Linux distribution,UserNameis the name of your user directory.Check the following example:
\\wsl.localhost\Ubuntu\home\test\MyProject.Interpreter: the Ruby interpreter or the version manager executable installed in WSL.
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.
Click Create.

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.
Click Open on the Welcome screen or select from the main menu.
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\DistributionNamewhereDistributionNameis the name of your Linux distribution such as Ubuntu, Debian, Arch, and so on.
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.
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.
