WSL

1. Open the Settings/Preferences dialog Ctrl+Alt+S, go to the Language & Frameworks | Ruby SDK and Gems page.

2. Click on the toolbar and select New remote in the drop-down:

   

3. In the invoked dialog, select WSL:

   

   Choose the desired Linux distribution.

   In Ruby or version manager path, specify the path to the Ruby interpreter or the version manager executable. Click OK.

4. (Optional) If you specified a path to the version manager executable in the previous dialog, RubyMine suggests selecting the Ruby interpreter used to run a remote application:

   

5. Select the added SDK in the Ruby SDK and Gems page:

   

6. (Optional) If you want to use the added SDK to debug a remote process, specify mappings between files of a local and remote project. To do this, click the Edit Path Mappings button. In the Edit Project Path Mappings dialog, specify the local and remote project root paths:

   

Add a custom distribution

1. Open the %APPDATA%\JetBrains\<product><version>\config\options\wsl.distributions.xml file.

2. Add the descriptor element and provide settings to access your custom distribution. Note that the id value should be unique. For example:

   <!-- ... -->
   <descriptor>
       <id>DEBIAN_CUSTOM</id>
       <microsoft-id>Debian</microsoft-id>
       <executable-path>debian-custom.exe</executable-path>
       <presentable-name>Debian GNU/Linux - Custom</presentable-name>
   </descriptor>
   <!-- ... -->

   You can specify executable-path in two ways:

   • Specify the executable name of a custom distribution. In this case, RubyMine will find a custom distribution in %LOCALAPPDATA%\Microsoft\WindowsApps.

   • Specify the absolute path to the custom distribution executable.

3. Restart RubyMine and add your custom distribution as a remote interpreter.