Installing Ronin on macOS

Copy/Paste Instructions

brew install gcc make ruby git zip
brew pin ruby
echo 'PATH="$(brew --prefix ruby)/bin:$PATH"' >> ~/.zshrc
echo 'PATH="$(gem env gemdir)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
sudo gem install ronin

Detailed Breakdown

Build Dependencies

First we will need to install a C compiler (gcc or clang) and make. These are required to install certain ruby gems, which contain C extensions (aka C bindings) to other C libraries, such as the nokogiri, sqlite3, and nio4r gems.

brew install gcc make

Ruby

Next, we will need to install Ruby >= 3.0.0, which should already be available in your system’s package manager.

brew install ruby

Next we will need to “pin” the Homebrew’s version of Ruby.

brew pin ruby

Then we will need to make Homebrew’s version of Ruby the default Ruby by adding it to the PATH environment variable in ~/.zshrc and reloading the shell’s configuration.

echo 'PATH="$(brew --prefix ruby)/bin:$PATH"' >> ~/.zshrc
echo 'PATH="$(gem env gemdir)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Runtime Dependencies

Next we will need to install additional utilities, such as git and zip, that parts of Ronin use:

brew install git zip

Ronin

Now that everything else is installed, it is time to install Ronin!

sudo gem install ronin

Postinstall

Assuming no errors occur, you should now be able to run ronin:

ronin help

Troubleshooting

Ruby and many ruby gems will not work if the LANG environment variable is not set or set to C. Make sure that LANG is set to a UTF8 language, such as en_US.UTF-8.