Frequently Asked Questions

I already know how to install Ruby, what do I gain from Ruby on Mac?

You will save a ton of time, which is our most limited and valuable resource. If you’re setting up a new Mac, or are planning on buying one soon, or getting one for a new job, would you rather spend several hours setting everything up manually, or run a single command that will do it all for you in about 15 minutes?

Ruby on Mac Prime also lets you easily customize which dev tools and even Mac apps you want to install. It comes with a starter template that already includes popular dev tools and Mac apps.

I’m not a developer and/or I’m new to Mac, will I be able to use Ruby on Mac?

Absolutely! Ruby on Mac is designed to be beginner-friendly. Follow the detailed step-by-step instructions, and you’ll be up and running in minutes. If you get stuck and the documentation isn’t helpful, I’ll be happy to walk you through it personally over Zoom.

Which versions of macOS are supported?

Ruby on Mac runs on Monterey, Big Sur, and Catalina. Give it a shot on older versions, but I can’t guarantee it will work.

Which processors are supported?

Ruby on Mac runs on Intel, M1, M1 Pro, M1 Max, and M1 Ultra.

Which versions of Ruby will I be able to install?

Ruby on Mac automatically installs the latest version of Ruby by default (currently 3.1.1). The Prime version also installs 2.7.5 for wider compatibility. For example, Jekyll currently doesn’t work with Ruby 3.x out of the box.

After you run Ruby on Mac, you’ll be able to install gems right away. The Prime version has an option to automatically installs Rails and Jekyll for you.

You’ll also be able to run a single command (using “ruby-install”) to install other Ruby versions that are officially maintained. Currently, that includes 2.6.9, 2.7.5, 3.0.3, and 3.1.1. Other versions within those series should work as well, such as 2.7.4.

On an M1 Mac, the oldest version you can install is 2.6.8. This is a limitation in Ruby itself, not due to anything Ruby on Mac does. That doesn’t mean you can’t run your old projects that have an older version for Ruby. You’ll just need to update your projects to use a newer version.

Note that the 2.6 series will reach end of life in March 2022, and will no longer be supported. I recommend upgrading any old projects to 2.7.x or 3.x.

To switch between versions, you’ll use the “chruby” tool. All of this explained in the detailed documentation that comes with Ruby on Mac.

Is the script guaranteed to work?

All versions of Ruby on Mac are guaranteed to set up a proper Ruby environment on Macs with a clean installation of a supported macOS, as provided by Apple. On top of that, the “Prime” version of Ruby on Mac is guaranteed to work even if your development environment is a hot mess.

In addition to unsupported macOS versions, I cannot guarantee Ruby on Mac will work on a Mac that was provided by your employer with software or files preinstalled on it that didn’t come from Apple.

Will the script fix issues with my old Ruby projects?

It depends. If you’re on an Intel Mac, you should be able to run your old projects after installing Ruby on Mac.

If you’re on an M1 Mac, depending on which version of Ruby your old project is using, it might not work out of the box. For example, you can’t install a version of Ruby older than 2.6.8 on an M1 Mac. So, if your project uses a version older than 2.6.8, you’ll need to update your project to use one of the newer versions that Ruby on Mac installs.

Similarly, if you have an older project with outdated or unsupported gems, running “bundle install” might result in errors. For example, “therubyracer” gem can’t be installed on M1 Macs. You’ll need to update your project so that it doesn’t depend on “therubyracer”.

If you haven’t yet run Ruby on Mac, and you’re not able to install the latest version of a particular gem, then Ruby on Mac is guaranteed to solve that problem. After running Ruby on Mac, if you can’t install the gems in your old project, or if you’re not able to run your project, that most likely means those errors are specific to your project, and not Ruby on Mac. I recommend updating any gems mentioned in the errors.

If you need help updating older projects, try my free guide How To Update Gems In Your Gemfile. If you prefer personalized help, the upcoming Pro version of Ruby on Mac will include a 30-minute consultation with me. You can preorder Pro for $99 to book your consultation. You’ll get Prime now, and Pro when it’s ready.

Can I upgrade later if I buy a lower tier now?

Absolutely! If you buy the “Basic” version, you’ll be able to upgrade to the “Prime” version later on.

The upgrade cost will be the difference between what you paid originally and the full cost of the Prime version at the time of the upgrade.

Please note that the price of the Prime version of Ruby on Mac will likely increase in the future, so it may cost more if you wait to upgrade.

Is there a money-back guarantee?

If Ruby on Mac doesn’t work for you as advertised, send me an email within 30 days and I’ll give you a refund.

Is there a student discount?

Yes! If you’re actively enrolled in an educational program, you can receive 20% off the full cost of the Prime version of Ruby on Mac. This discount can’t be combined with any other discounts.

This discount is intended for full-time or part-time students, including coding bootcamps like General Assembly.

To get your unique coupon code, email me at moncef@rubyonmac.dev with proof of enrollment.

On how many computers can I run the script on?

For individual licenses, as many as you want, as long as they are your personal computers.

If you purchased a team license, you can share it with your entire team. See the License for more details about what you can and can’t do.

What does “lifetime access” mean exactly?

Ruby on Mac is a one-time purchase, with no recurring subscription. When you purchase a Ruby on Mac version, you have access to all of the content in that version forever.

What does “future updates” include?

Since I use Ruby on Mac regularly to set up my computers and keep them secure and up to date, I’ll make improvements to keep it as easy to use as possible, and to make sure it continues to work on current and future macOS versions.

Can I purchase a license for my entire team?

Yes! You can purchase a license that you can share with your entire team, including current and future team members, for a one-time fee of $899 USD.

The team license includes the upcoming Pro version (priced individually at $99).

Buy a Pro team license for $899 USD

You’ll get the Prime version now, and Pro when it’s released.

Can I upgrade to a team license later?

Yup! If you’re a solo developer, you can start with a regular “Prime” license, and then upgrade to the team license later if other developers join your team.

When you’re ready to upgrade, email me at moncef@rubyonmac.dev and I’ll take care of it.

Can I get a receipt, so I can be reimbursed?

Right after purchasing, you’ll be emailed a receipt/invoice from Paddle, the service I use to process payments. You’ll be able to add whatever name and address is necessary to get reimbursed.

You can also add your VAT number, to have any VAT charges reimbursed.

Why chruby and not asdf, rbenv, or RVM?

In the upcoming Pro version of Ruby on Mac, you’ll be able to choose your preferred version manager.

For the Basic and Prime versions, I chose chruby because it’s the simplest, most reliable, and easiest to understand for most people. I like that it does not do some of the things that other Ruby managers do:

  • Does not hook “cd”.
  • Does not install executable shims or require regenerating them after installing gems.
  • Does not require Rubies to be installed into your home directory.
  • Does not automatically switch Rubies by default.
  • Does not require write-access to the Ruby directory in order to install gems.

Can I read the script before I run it?

Absolutely! And you should! When you buy Ruby on Mac, you’ll get a folder that contains detailed documentation, as well as the script itself, which you can open with any text editor.

Do you support Purchasing Power Parity (PPP)?

If you absolutely can’t afford Ruby on Mac, I’m happy to give you a discount. To get a discount code, send me an email with your country, and which version of Ruby on Mac you want to buy.

You have another question?

Email me at moncef@rubyonmac.dev and I’ll do my best to get you an answer within a few working hours.