Install Ruby (macOS)

Install Ruby on macOS with a version manager. macOS ships a system Ruby, but it is outdated and owned by the OS. Installing gems into it needs sudo and can break system tools, as noted in the fastlane iOS setup guideopen_in_new.

1. 1

   Install Homebrew (if needed)

   sports_bar

   Homebrewlatest

   The macOS package manager used by the other macOS install commands.

   laptop_macbrew.shopen_in_new

   macOS · Terminal

   content_copy

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

   Verify: brew --versioncontent_copy

   Follow brew.shopen_in_new, then confirm with brew --versioncontent_copy.

2. 2

   Install rbenv and Ruby 3.4.1

   my-app — zshcontent_copy

   ~/my-app $ brew install rbenv ruby-buildcontent_copy
   ~/my-app $ rbenv initcontent_copy
   # Follow the printed instruction (adds rbenv to ~/.zshrc), then open a new terminal
   ~/my-app $ rbenv install 3.4.1content_copy
   ==> Installed ruby-3.4.1 to /Users/you/.rbenv/versions/3.4.1
   ~/my-app $ rbenv local 3.4.1content_copy
   # writes .ruby-version in the project root

3. 3

   Install Bundler

   my-app — zshcontent_copy

   ~/my-app $ gem install bundlercontent_copy
   Successfully installed bundler-2.6.2

4. 4

   Verify

   my-app — zshcontent_copy

   ~/my-app $ which rubycontent_copy
   /Users/you/.rbenv/shims/ruby
   ~/my-app $ ruby --versioncontent_copy
   ruby 3.4.1 (2024-12-25 revision 48d4efcb85) +PRISM [arm64-darwin24]
   ~/my-app $ bundle --versioncontent_copy
   Bundler version 2.6.2

Next steps