Goodbye gem installation issues. Hello Ruby on Mac.
Before Ruby on Mac: Spend days trying to get your Rails, Jekyll, iOS, or other Ruby project working. With Ruby on Mac: Run a single command and you'll be up and running in minutes.
I don’t remember exactly how I arrived at your site but it was after a lot of googling and trying to fix problems. I came across your landing page and kept it in a tab and after an hour or so I came across your site again and just bought it. I was really frustrated and gladly paid to have that problem fixed.
Have you been struggling to install Rails, Jekyll, cocoapods, fastlane, ffi, or some other Ruby gem? Or even just Ruby? You had no idea it would be this complicated, right?
You've been searching Google for days, asking questions on Stack Overflow, Reddit, and GitHub. Some say use "sudo", others say don't. RVM this, rbenv that. You run commands blindly, hoping something will work.
But nothing you've tried so far has worked.
Does this permissions error look familiar?
ERROR: While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /Library/Ruby/Gems/2.6.0
How about this one after using "sudo" to install the gem?
ERROR: Failed to build gem native extension.Or maybe you followed outdated advice to use Rosetta, "arch -x86_64", or "LDFLAGS", and now you're getting an error about incompatible architecture:
bundler: failed to load command: jekyll
incompatible architecture (have x86_64 need arm64e)
Every fix you've tried so far ends in more misery that makes you want to give up.
You're not alone. Every day, hundreds of people — from beginners to those with 40 years of coding experience — struggle to install and use Ruby gems on a Mac.
This is what it sounds like when devs cry:
Hi I've been trying to get rails and postgresql installed for 2 days now and its been a nightmare, does anyone know of a step by step up to date tutorial to install rails on mac please? I've tried go rails, other websites and videos but keep getting errors and I find myself pasting fixes from stackoverflow to fix one issue then I run into another.
What if you already have a Ruby environment, but it's so old that you can't get started on that dream project of yours?
I’ve got an itch to work on a web app and a Mac that is many versions behind on Ruby, Rails, etc. I keep running into all sorts of problems as I try to update. Is there an easy way to blast away all this old cruft and start over short of reformatting the hard drive?
You know it's possible to use Ruby on a Mac, you just don't think YOU can do it.
But what if you could? What if you could run a single command in your Terminal, and it would automatically set up a proper Ruby development environment?
You'd be able to start working on your project minutes from now.
It's true, following outdated tutorials, and copying and pasting a bunch of commands by hand can leave your Mac in a hot mess. But there's a better way!
Stop struggling with Ruby. Let Ruby on Mac set everything up for you.
Meet your lifesaver, Ruby on Mac
Ruby on Mac comes in two flavors: Basic and Prime. Depending on what you've already done to your Mac, or if your dev environment is an old and tangled mess, Ruby on Mac Basic might not work the first time. However, you'll get a comprehensive troubleshooting guide, which includes a step-by-step section for cleaning everything up and starting over from scratch.
That alone will save you hours, maybe even days, that you would have spent backing up your computer, erasing your hard drive, and reinstalling macOS. But it still involves about 37 steps.
The Prime version comes with a reset mode, which runs those 37 steps in less than 60 seconds.
Even if you have a clean Mac, if you were to set everything up manually on your own, it would take at least an hour. You would have to follow several steps in the right order to get Ruby properly installed. And then you would need to install and configure several other dev tools.
Ruby on Mac automates the whole process for you in minutes, with a perfect result every time.
Ruby on Mac is a shell script that uses a specific recipe to guarantee a successful installation whether you have an Intel Mac or an Apple Silicon M1 Mac. It also detects whether you're using Bash, zsh, or Fish, and configures your shell automatically.
All versions of Ruby on Mac use Homebrew as the foundation of your development setup. The Basic version installs chruby and ruby-install with Homebrew, then installs the latest version of Ruby. This is the minimum required to work with Ruby.
Automating a proper Ruby installation is already a time saver, but Ruby on Mac Prime goes beyond that by giving you these additional benefits:
- If your existing dev environment is not working, Ruby on Mac Prime will safely clean it up in less than 60 seconds, and reinstall everything from scratch.
Web development tools
- Ruby on Mac Prime installs all the tools you'll need to get started right away: Bundler, Jekyll, Rails, Git, GitHub CLI, Heroku CLI, Node, Nodenv, Postgres, Redis, and Yarn.
- Ruby on Mac Prime comes with a Brewfile that includes the most popular dev tools and Mac apps. Discover new useful dev tools and Macs apps, and save half a day when setting up a new Mac. Macs apps are installed with Homebrew Cask and mas.
Keeps your system up to date and secure
- Ruby on Mac Prime comes with a terminal shortcut that makes it easy to run the script safely over and over by typing "rom". Each time the script runs, it only installs what you don't already have, and if it finds a new version of an existing tool or Mac app, it will update it.
Faster gem installation
- Ruby on Mac Prime configures Ruby to install gems up to 4 times faster than the Basic version. This can add up to minutes saved each time you install or update gems.
- By using different colors for prompts, information, success, and failure, it makes it easier to see what's happening while the script is running.
Trusted by developers at
The script worked like a charm, and solved my problems. Thank you very much. All previous methods for installing Jekyll on a Mac M1 didn’t work for me.
Buy once, save time over and over.
Get lifetime access, plus any future updates for a simple one-time price.
You'll save hours now, and the next time you get a new Mac, and the time after that, forever.
Tip: you may be able to expense your Ruby on Mac purchase with your company.
Everything in Basic
Reset mode to clean up and start from scratch
Bundler, Jekyll, Rails
Git, GitHub CLI, Heroku CLI
Node, Nodenv, Postgres, Redis, Yarn
Install Mac apps with Homebrew Cask and mas
Terminal shortcut to easily rerun the script
Support for fish shell
Install gems 4x faster
Keeps Rubygems up to date
Homebrew, Command Line Tools
Latest Ruby with chruby and ruby-install
Comprehensive troubleshooting guide
“Your script flawlessly installed Ruby 2.7.2, bundler, rails, sassc 2.4.0, and jekyll! You have truly earned the title of wizard, at least in my book! In my view you are unique in (a) providing an automated script that actually works; and (b), more importantly, in filling what is in my experience a complete vacuum in support from the Jekyll site itself.”
“Thanks for the script, it really helped me get started with a lot of ease and minus the nightmares I faced for about 3 days trying to get it all up and running!”
“I just wanted to say a big thank you for this script!! It’s just worked wonders getting Jekyll up and running on my new Apple M1 MacBook, after I’ve spent 2 days scratching my head trying to get everything setup.”
“You (and your wonderful script) saved me from great peril today. I had developed my first Jekyll site some months ago. And I am now in the middle of developing a site using Eleventy. Earlier today, I went back to my Jekyll site to make sure that I could still build it as I had some updates to make. Sadly, the site failed to build with the horrendous "ffi" error that is going around. After numerous ill-fated attempts to get it working, trying every workaround that I could find, I ultimately came across your script. While it does take some time to get through it, I have to say that it has worked wonderfully! My site builds once again and I feel like the ruby platform that your script placed on my system is far less fragile than before. Thank you again for the great script and your service to the community. ”
“YES, the script worked, thank you so much for your work. I stumbled upon it because somehow my gems didn’t work anymore and my dev setup has been a mess since forever, and it was great to get it running as a fresh start. ”
“thank you thank you thank you - I've spent days trying to sort this out and you have definitely come to my rescue.”
“Thanks so much for the script, it worked brilliantly. I'm not a coder as such, and I am new to Mac, but I needed to set up an environment for viewing github pages files, and it required ruby, bundle, etc. but especially, jekyll, which I just could not get to install. So after viewing your instructions, it worked a treat.”
“You are a lifesaver, I was struggling with installing rails on my m1 MBP and your script saved all the hassle. Clear cut instructions and all steps noted very well. I have become a fan.”
Is there a money-back guarantee?
If Ruby on Mac doesn't work as advertised for you, send me an email within 30 days and I'll give you a full refund. If you bought the Prime version and it didn't work, I will personally set up your Mac for you.
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.
How do I use Ruby on Mac after I buy it?
When you buy Ruby on Mac, you'll get a link to download a zip file that includes the script and detailed documentation.
After reading through the documentation, copy and paste the command from the installation instructions into your terminal, and you'll be up and running in minutes.
Can I read the script before I run it?
Absolutely! You can open and read the various scripts with any text editor.
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.
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).
You'll get the Prime version now, and Pro when it's released.
Will the script fix issues with my old legacy 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 safely 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 supported 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 to Prime later if I buy Basic now?
Absolutely! 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.
Note that the price of Prime will likely increase in the future, so it may cost more if you wait 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 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 with proof of enrollment.
You have another question?
Check out the full FAQ.
Who created Ruby on Mac?
Hi there! I'm Moncef Belyamani. I have two passions in life: music and helping people set up Ruby on their Mac.
Ten years ago, I wanted to start my first programming blog. I thought it would help me get a job as a developer. I wanted to use Octopress, a gem based on Jekyll.
Just like you, I ran into lots of problems. I spent hours searching for a solution. But then I figured out the exact step-by-step recipe for setting up Ruby on a Mac.
That was my first blog post, and it quickly became popular. It also helped me get accepted into the Code for America Fellowship, which changed my life.
I spent the next eight years in Civic Tech, working on open source projects used by millions of people. I helped shape Engineering best practices, and saved over 1000 hours using my automating skills.
Over the past ten years, I've helped thousands of people set up Ruby on their Mac. I've seen all the common errors, as well as obscure ones. Ruby on Mac Prime handles them all. Knowing how painful it can be to get started with Ruby, I've made it as easy as possible.