Laptop is a script that will set up a complete Ruby web development environment on your Mac. It also automatically installs the Jekyll and Rails gems.

It can be run multiple times on the same machine safely. It installs, upgrades, or skips packages based on what is already installed on the machine.

You can also easily customize the script to install additional tools.

• Join the 1000+ people on my list who are becoming confident coders through my free weekly coding guides and exclusive tutorials and courses.
• For a more minimal script that only installs Ruby (with chruby and ruby-install), check out my install-ruby-on-macos script.

Supported chips:

• Apple Silicon M1 (native)
• Apple Silicon M1 (with Rosetta)
• Intel

Supported operating systems:

• Big Sur
• macOS Catalina
• macOS Mojave

Unsupported operating systems. Give it a shot, but I can't guarantee it will work.

• macOS High Sierra (10.13)
• macOS Sierra (10.12)
• OS X El Capitan (10.11)
• OS X Yosemite (10.10)
• OS X Mavericks (10.9)

Supported shells:

• bash
• zsh
• fish (see the note at the bottom of this README)

IMPORTANT: Before you run the script, make sure you have the latest Apple software updates installed. Check by going to System Preferences, then Software Update. If you're on Catalina, you don't have to upgrade to Big Sur, just make sure you have the latest Catalina updates.

Also, please make sure to read everything on this page for caveats, troubleshooting tips, and to make sure the script worked.

Begin by opening the Terminal application on your Mac. The easiest way to open an application in macOS is to search for it via Spotlight. The default keyboard shortcut for invoking Spotlight is command-Space. Once Spotlight is up, just start typing the first few letters of the app you are looking for, and once it appears, press return to launch it.

In your Terminal window, copy and paste the command below, then press return.

bash <(curl -s https://raw.githubusercontent.com/monfresh/laptop/master/laptop)

The script itself is available in this repo for you to review if you want to see what it does and how it works.

Note that the script might ask you to enter your macOS password at various points. This is the same password that you use to log in to your Mac. The prompt comes from Homebrew, because it needs permissions to write to the /usr/local (or /opt/homebrew on M1 Macs) directory.

If you have rbenv or RVM installed, the script will ask you to uninstall them first and run the script again. Look at the script output for uninstallation instructions.

Once the script is done, quit and relaunch Terminal.

I recommend running the script regularly to keep your computer up to date. Once the script has been installed, you'll be able to run it at your convenience by typing laptop and pressing return in your Terminal.

Your last laptop run will be saved to a file called laptop.log in your home folder. Read through it to see if you can debug the issue yourself, with the help of the Troubleshooting Errors Wiki article. If not, copy the entire contents of laptop.log into a new GitHub Issue (or attach the whole log file to the issue) for me and I'll be glad to help you. If the script doesn't work for you, it's most likely a bug in my script, which I'd love to fix, so please don't hesitate to report any issues.

If the last thing the script displayed was "All done!", then everything the script was meant to do worked.

To verify that the Ruby environment is properly configured, quit and restart Terminal, then run these commands:

ruby -v

This should show ruby 2.7.2 or ruby 3.0.0. If not, try switching manually to 2.7.2:

chruby 2.7.2

and check the version to double check:

ruby -v

Then check where Ruby is installed:

which ruby

This should point to the .rubies directory in your home folder. For example:

/Users/monfresh/.rubies/ruby-2.7.2/bin/ruby

Once you've installed the script successfully and restarted your terminal, creating a new Rails app takes just 3 more steps.

Similarly to Rails, creating a new Jekyll site is just as easy.

The first time you run the script (assuming you didn't already have chruby installed), it will install Ruby 2.7.2, which is the version that is compatible with most gems at the moment. If you run the script again, it will check for newer versions, and it will install Ruby 3.0.0, which was released on December 25, 2020. You will still have Ruby 2.7.2. That's the advantage of using version managers like chruby. You can have many different versions installed at the same time and you can switch between them.

Ruby 3.0 is still very new, so it's not yet fully compatible with gems like Rails or Jekyll. So, before you create a new Rails app or Jekyll site, make sure you're using Ruby 2.7.2. Keep reading for instructions.

To check if you have Ruby 2.7.2 installed, run this command:

find "$HOME/.rubies" -maxdepth 1 -name 'ruby-2.7.2'

If nothing is returned, then you should install it:

ruby-install ruby-2.7.2

To switch to this newly-installed version, run chruby followed by the version. For example:

chruby 2.7.2

You should run chruby 2.7.2 before you start any new project to make sure you are using the correct version of Ruby.

Another highly-recommended way to automatically switch between versions is to add a .ruby-version file in your Ruby project with the version number prefixed with ruby-, such as ruby-2.7.2. To test that this works:

1. cd into your Ruby project, such as your Rails app or Jekyll site
2. First, check to see if the file already exists: cat .ruby-version. If not, then create it in the next step.
3. Create a file called .ruby-version with ruby-2.7.2 in it:

   echo 'ruby-2.7.2' >> .ruby-version

4. cd into a folder outside of your project, such as your home folder: cd ~
5. Run ruby -v. It will probably say 2.6.3p62, which is the Ruby that came preinstalled on your Mac.
6. cd into your project
7. Verify that ruby -v shows 2.7.2p137

Note that gems only get installed in a specific version of Ruby at a time. If you installed jekyll in 3.0.0, and then you install 2.7.2 later, you'll have to install jekyll again in 2.7.2.

To verify if Node was installed and configured:

node --version

You should see v14.15.3 or later

nodenv help

You should see various commands you can run with nodenv.

The next thing you'll want to do after running the script is to configure Git with your name, email, and preferred editor.

This script used RVM at first, but it started causing problems, so I switched to chruby, and haven't had any issues since. chruby is also is the simplest, most reliable, and easiest to understand. 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.
• 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.

Other folks who prefer chruby:

• https://kgrz.io/programmers-guide-to-choosing-ruby-version-manager.html
• https://stevemarshall.com/journal/why-i-use-chruby/
• https://linhmtran168.github.io/blog/2014/02/27/moving-from-rbenv-to-chruby/

• Bundler for managing Ruby gems
• chruby for managing Ruby versions (recommended over RVM and rbenv)
• GitHub CLI brings GitHub to your terminal.
• Heroku Toolbelt for deploying and managing Heroku apps
• Homebrew for managing operating system libraries
• Homebrew Cask for quickly installing Mac apps from the command line
• Homebrew Services so you can easily stop, start, and restart services
• Jekyll for creating static sites
• Nodenv to easily install and manage Node versions
• Rails for creating modern web apps
• Postgres for storing relational data
• ruby-install for installing different versions of Ruby
• Yarn to manage JS dependencies

It should take less than 15 minutes to install (depends on your machine and internet connection).

# Go to your macOS user's root directory
cd ~

# Download the sample files to your computer
curl --remote-name https://raw.githubusercontent.com/monfresh/laptop/master/.laptop.local
curl --remote-name https://raw.githubusercontent.com/monfresh/laptop/master/Brewfile.local

# open the files in your text editor
open .laptop.local
open Brewfile.local

Your ~/.laptop.local is run at the end of the mac script. Put your customizations there. If you want to install additional tools or Mac apps with Homebrew, add them to your ~/Brewfile.local. You can use the .laptop.local and Brewfile.local you downloaded above to get started. It lets you install the following tools and Mac apps:

• Firefox for testing your Rails app on a browser other than Chrome or Safari
• Flux for adjusting your Mac's display color so you can sleep better
• GitHub Desktop for working with your repos using a GUI
• iTerm2 - an awesome replacement for the macOS Terminal
• Nova - Panic's new macOS native code editor
• Redis for storing key-value data
• Sublime Text 3 - a solid and fast code editor
• Visual Studio Code - Microsoft's popular code editor

Write your customizations such that they can be run safely more than once. See the mac script for examples.

Laptop functions such as fancy_echo, and gem_install_or_update can be used in your ~/.laptop.local.

If you want to skip running .laptop.local, you can set the SKIP_LOCAL environment variable to true before running laptop:

export SKIP_LOCAL=true
laptop

The script does not automatically launch these services after installation because you might not need or want them to be running. With Homebrew Services, starting, stopping, or restarting these services is as easy as:

brew services start|stop|restart [name of service]

For example:

brew services start postgresql

To see a list of all installed services:

brew services list

To start all services at once:

brew services start --all

chruby does not support the fish shell out of the box. There is a chruby-fish tool, but it has bugs that manipulate the PATH in a way it shouldn't. This can prevent using Nodenv if Node is already installed with Homebrew. This is just one example of issues you might run into and not understand why things aren't working. Until the issues are fixed, here is a workaround you can use:

1. Uninstall chruby-fish if you have it: brew uninstall chruby-fish
2. Clone this fork of chruby-fish to your computer:

   git clone https://github.com/bouk/chruby-fish/tree/rewrite-fish

3. Check out the rewrite-fish branch:

   cd chruby-fish
   git checkout -b rewrite-fish origin/rewrite-fish

4. Run make install
5. Remove any lines from your fish config file that source chruby, such as:

   source /usr/local/share/chruby/chruby.fish
   source /usr/local/share/chruby/auto.fish
   source /usr/local/share/chruby/chruby.sh
   source /usr/local/share/chruby/auto.sh
   

6. Quit and restart Terminal

See this pull request for more information: JeanMertz/chruby-fish#39

This laptop script is inspired by thoughbot's laptop script.

thoughtbot's original work remains covered under an MIT License.

My work on this project is in the worldwide public domain, as are contributions to my project. As stated in CONTRIBUTING:

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.