RubyMine Debugger Not Working / Not Attaching

Share
Ongoing Windows, macOS, Linux Updated November 14, 2026How we research

Quick answer

RubyMine uses debase and ruby-debug-ide (or the debug gem on MRI 2.6+). Missing build tools or byebug can break it.

Most likely fix: Install the debugger gems

How to fix it

Try these in order — the most common fix is first.

  1. 1. Install the debugger gems

    1. Accept the prompt to install debase and ruby-debug-ide on first debug
    2. Install build tools: Command Line Tools (macOS), build-essential (Linux), Ruby+DevKit (Windows)
    Did this fix it?
  2. 2. Remove interference

    1. Third-party gems such as byebug can affect the debugger; remove them while debugging
    Did this fix it?
  3. 3. Debug gem

    1. Apps using the debug gem need Ruby MRI 2.6 or later
    Did this fix it?

Symptoms

Debug session fails to start, gems fail to install, or debugging is slow.

Why it happens

  • debase / ruby-debug-ide not installed
  • Missing system libraries to compile gems
  • byebug or similar gems interfere
  • Older Ruby or JRuby limits

This guide also covers

  • rubymine debugger not working
  • rubymine debase ruby-debug-ide
  • rubymine debug not attaching

Still not working?

If RubyMine keeps failing, you're not alone. See every RubyMine problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us
Fixed it? Share this guide

Other RubyMine errors