Frequently Asked Questions

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 full refund. If you bought the Prime or Ultimate version and it didn’t work after using the reset mode, I will personally set up your Mac for you.

Please read the next FAQ (below this one) about issues that are specific to your existing projects since Ruby on Mac is not guaranteed to fix those.

All versions are guaranteed to work the first time you run it on a clean installation of a supported macOS, as provided by Apple.

If you already had dev tools installed and the script fails, the Prime and Ultimate versions can safely clean everything up automatically in 60 seconds using the "reset" mode. With the Basic version, you’ll need to spend 60 minutes following the step-by-step instructions in the troubleshooting guide to manually clean everything up. You can then run the script again, and it will work this time.

I do not provide support for macOS versions older than Catalina, and for pre-release versions, such as the current Ventura Beta. No refunds will be given for script failures on unsupported macOS versions.

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 Apple Silicon Mac (M1/M2), depending on which version of Ruby your old project is using, it might not work out of the box. For example, you can’t safely install a version of Ruby older than 2.6.8 on an Apple Silicon Mac without messing with compilation flags. 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” or “rails s” might result in errors. For example, “therubyracer” gem can’t be installed on Apple Silicon 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 supported gem (meaning the gem says it works on Apple Silicon Macs), 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 Ultimate version of Ruby on Mac includes a 30-minute consultation with me, among many other exclusive time-saving features.

Do you support Purchasing Power Parity (PPP)?

Yes! If you visit from a country with low purchasing power, you should see a banner at the top with a coupon code you can use. If you don’t see a banner, try turning off your VPN.

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?

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. It will not work on the current Ventura Beta because Homebrew doesn’t support pre-release versions of macOS. I do not provide support for older versions, and for pre-release versions. No refunds will be given for script failures on unsupported OSes.

Which processors are supported?

Ruby on Mac runs on Intel, and all Apple Silicon chips (M1/M2).

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.2). The Prime and Ultimate versions also install 2.7.6 for wider compatibility.

After you run Ruby on Mac, you’ll be able to install gems right away. The Prime and Ultimate versions can automatically install Rails, Jekyll, and Cocoapods 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.10, 2.7.6, 3.0.4, and 3.1.2. Other versions within those series should work as well, such as 2.7.4.

On an Apple Silicon Mac, the oldest version you can safely install in native mode is 2.6.8. This is a limitation in Ruby itself, not due to anything Ruby on Mac does. That doesn’t mean you won’t ever be able to run your projects that have an older version of Ruby. You’ll just need to update your projects to use a newer version.

Note that the 2.6 series reached end of life in March 2022, and is no longer 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.

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

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

Note that the price of Ultimate will definitely increase in the future, so it will cost more if you wait too long to upgrade.

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 or Ultimate versions 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 an Ultimate Team license, you can share it with your entire team up to 25 people. See the License for more details about what you can and can’t do.

How long can I keep using Ruby on Mac?

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

If you buy the Basic or Prime version, you’ll get free updates and bug fixes for one year. After that, if it stops working for some reason, due to macOS changes for example, you’ll need to buy it again to get another year of updates.

If you buy the Ultimate version, you get unlimited free updates.

What does “free updates” include?

Since I use Ruby on Mac regularly to set up my own computers and keep them secure and up to date, I’m making improvements regularly 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! The team license is available with the Ultimate version of Ruby on Mac. You can purchase a license that you can share with up to 25 people for a one-time fee of $899 USD.

Buy an Ultimate Team license for $899 USD

Can I upgrade to a team license later?

Yup! If you’re a solo developer, you can start with a regular license, and then upgrade to the Ultimate 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 Ultimate version of Ruby on Mac, you’ll be able to choose your preferred version manager. This feature is coming soon.

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.

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.