Install portable-ruby with Homebrew

Project links

• Homepage
• Package manager page

Commands and aliases

• bootsnap

Project history

Ruby itself was created by Yukihiro Matsumoto in 1993 as an object-oriented scripting language. Homebrew later created Portable Ruby builds that could be installed and executed from different filesystem locations.

The dedicated homebrew-portable-ruby tap contained formulae and tools for building those relocatable runtimes. Its official README now marks the tap deprecated and explains that the work moved into Homebrew's main brew and homebrew-core repositories.

Adoption history

Portable Ruby is primarily Homebrew infrastructure. Homebrew's runtime-selection code installs the vendored build when a suitable system Ruby is unavailable, while the official formula supplies relocatable bottles for supported macOS and Linux architectures.

The former dedicated tap was eventually archived after its formulae and build tooling moved into Homebrew/brew and Homebrew/homebrew-core. The packaging concept continued even though its repository home changed.

How it is used

Homebrew automatically selects its vendored Portable Ruby when the system lacks a suitable interpreter. Users can also install the keg-only formula, but it is principally infrastructure for Homebrew rather than a Ruby version manager or application-specific environment.

The formula provides the Ruby interpreter and standard Ruby tooling, while including Bootsnap for faster loading and cache precompilation.

Why package nerds care

Portable Ruby is an example of a package manager packaging its own implementation language to reduce dependence on host operating-system runtimes. Relocatability and conservative compatibility matter more here than presenting another general-purpose Ruby installation to users.

This bootstrapping pattern lets Homebrew run consistently across machines whose system Ruby versions, library layouts, or availability differ.

Timeline

• 1993: Yukihiro Matsumoto begins Ruby.
• Portable Ruby era: Homebrew creates relocatable Ruby builds for package-manager bootstrapping.
• 2025: The dedicated homebrew-portable-ruby repository is archived after the work moves into Homebrew/brew and homebrew-core.

Related projects

• Ruby is the upstream language and interpreter packaged by Portable Ruby.
• Homebrew/brew consumes Portable Ruby as a vendored runtime when the host does not provide a suitable interpreter.
• Bootsnap is bundled by the formula to accelerate Ruby loading and compilation-cache workflows.

Sources

• https://github.com/Homebrew/brew/blob/main/Library/Homebrew/utils/ruby.sh
• https://github.com/Homebrew/homebrew-core/blob/HEAD/Formula/p/portable-ruby.rb
• https://github.com/Homebrew/homebrew-portable-ruby
• https://www.ruby-lang.org/en/documentation/faq/1/