RubyMine 2026.1 Help

Debug

RubyMine provides a debugger for Ruby code. Depending on the installed/enabled plugins, you can also debug code written in other languages, including ERB and HAML files.

For Ruby 2.0+ projects, the RubyMine debugger uses the debase and ruby-debug-ide gems added to the project interpreter. RubyMine will suggest installing these gems when you run debugging for the first time.

To install the debugging gems, RubyMine requires additional system libraries:

  • Windows: Ruby+DevKit

  • macOS: Command Line Tools

  • Linux: the build-essential package

RubyMine can also debug applications that use the debug gem. The debug gem requires Ruby MRI 2.6 or later.

General debugging procedure

  1. (Optional) Configure the debugger settings in the Settings | Build, Execution, Deployment | Debugger page.

  2. If necessary, create or modify an existing run/debug configuration.

  3. Place breakpoints in your code.

  4. Start the debugger session.

  5. During a debug session, examine the program state: see variable values, evaluate expressions, and so on. You can also use the Debug console to do this.

  6. Step through the program.

22 May 2026