WSL

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, on the Marketplace tab, click Install. Wait for RubyMine to install the plugin, switch to the Installed tab, and make sure it is enabled. If not, click Enable.

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

   The image below shows the plugin in the enabled state.

   

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

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.

   

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.

      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.

   

   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, select the folder in the WSL file system that contains the project to open, or type the path to the project location manually.

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