Skip to content


Repository files navigation

Gem Version Build Status


The 'ruby-debug-ide' gem provides the protocol to establish communication between the debugger engine (such as debase or ruby-debug-base) and IDEs (for example, RubyMine, Visual Studio Code, or Eclipse). 'ruby-debug-ide' redirect commands from the IDE to the debugger engine. Then, it returns answers/events received from the debugger engine to the IDE. To learn more about a communication protocol, see the following document: ruby-debug-ide protocol.

Install debugging gems

Depending on the used Ruby version, you need to add/install the following debugging gems to the Gemfile:

For Windows, make sure that the Ruby DevKit is installed.

Start debugging session

To start the debugging session for a Rails application, run the following command:

rdebug-ide --host --port 1234 --dispatcher-port 1234 -- bin/rails s

If you want to debug a Rails application run using Docker Compose, you need to start the Rails server from the Docker in the following way:

command: bundle exec rdebug-ide --host --port 1234 -- bin/rails s -p 3000 -b
  - .:/sample_rails_app
  - "1234:1234"
  - "3000:3000"
  - "26162:26162"

Note that all ports above should be exposed in the Dockerfile.