Skip to content

Ruby and rbenv Cheat Sheet

Essential Ruby and rbenv Commands

Check Installed Ruby Version

1
ruby -v

Install Multiple Ruby Versions

1
2
rbenv install 3.0.6
rbenv install 3.1.0

List Installed Versions

1
rbenv versions

Set Global Ruby Version

1
rbenv global <version>

Set Local Ruby Version (Per Directory)

1
rbenv local <version>

Update Shims (Ensure Commands Use the Correct Ruby Version)

1
rbenv rehash

Install a Gem System-Wide

1
gem install <gem_name>

Troubleshooting Running WPScan with Ruby 3.0.6 and Metasploit with Ruby 3.1.0

Step 1: Set Global Ruby Version for WPScan

To ensure WPScan runs with Ruby 3.0.6, set it as the global version:

1
2
rbenv global 3.0.6
rbenv rehash

Verify the active version:

1
rbenv versions

Install WPScan:

1
gem install wpscan

Step 2: Configure Ruby 3.1.0 for Metasploit

To ensure Metasploit uses Ruby 3.1.0, set a local Ruby version inside its directory:

1
2
3
cd /usr/share/metasploit-framework
rbenv local 3.1.0
rbenv rehash

Running Metasploit from Any Directory

By default, msfconsole -q will only work inside /usr/share/metasploit-framework. To run it from anywhere, use one of these approaches:

Approach 1: Specify the Version Inline

1
RBENV_VERSION=3.1.0 msfconsole -q

Modify your .zshrc file:

1
sudo nano ~/.zshrc

Add the following function at the bottom:

1
2
3
4
5
# Wrapper for Metasploit to ensure it runs with Ruby 3.1.0
msfconsole() {
  echo "Launching Metasploit..."
  (cd /usr/share/metasploit-framework && exec /usr/share/metasploit-framework/msfconsole "$@")
}

Apply the changes:

1
source ~/.zshrc

Now, both wpscan and msfconsole can be used from anywhere in the system with their respective Ruby versions.

Last update: 2025-02-23
Created: February 23, 2025 12:06:38