Brew Macos Big Sur



I had to do this after upgrading to MacOS Big Sur, but once I did, all the following commands worked fine. Just re-run the above pyenv install 3.9.2 and it should now work. How to Set Up Your MacOS PATH for pyenv (Bash or ZSH) First you need to update your Unix path to pave a way for PyEnv to be able to interact with your system. Feb 10, 2021 Solution macOS could not be installed on your computer OSInstall.mpkg appears to be missing or damaged; Add Bookmark macOS Safari; How to install Java on macOS Big Sur Move from Zsh to Bash shell macOS; WARNING: Python 2.7 is not recommended macOS Big Sur This operation couldnt be completed. Unable to locate a Java Runtime. #fish-shell #brew #macos UPDATE: Upgrading to fish 3 solves the issues now. If you have decided to upgrade to the latest macOS Big Sur 10.14.6, you might have experienced an issue with slow autocomplete in fish-shell.

on VMware ESXi 6.7 U3 P02


** UPDATE 12/03/2020**

This now installs natively on ESXi 6.7 Update 3 Patch 02 - 202004002
I followed my same procedure below after downloading Catalina and Big Sur.
** I increased the image sise to 13GB as Some Catalina versions were greater than 8GB and Big Sur is 12.9GB
hdiutil create -o /tmp/catalina -size 13000m -layout SPUD -fs HFS+J
hdiutil attach /tmp/catalina.dmg -noverify -mountpoint /Volumes/install_build
/Applications/Install macOS Catalina.app/Contents/Resources/createinstallmedia --volume /Volumes/install_build
hdiutil convert /tmp/catalina.dmg -format UDTO -o ~/Downloads/catalina
mv ~/Downloads/catalina.cdr ~/Downloads/catalina.iso
Next, I copy the ISO to a external system (my desktop) an a network drive where I will install from.
In VMware (I am using vCenter)
Name it, I use macos-catalina
Pick a folder, Pick a Server/resource Pool and Pick Storage
For Compatibility, click the dropdown and select ESXi 6.7 Update 2 and later
For Select OS, click the Gueast OS Family drop down and select Other
For Guest OS Version, click the dropdown and select Apple macOS 10.14 (64-bit)
Under the datastore, I choose Disk Provisioning Thin Provision
Finish and save the VM
To install, I open a remote console on the VM
Select VMRC - > Removable Devices -> CD/DVD Drive1 -> Connect to Disk Image File (ISO)
In the OS boot menu, select SATA CD/DVROM, then boot to the installer
Select the VMware Virtual Disk
Give the disk a name
Start the macOS installer and complete the install steps. This takes about 45 minutes total.
Once installed, disconnect the ISO from the console client.
Reboot one last time to make sure it still boots OK.


** UPDATE 04/15/2020**
Seems you need to start at Mojave to be able to download the full Catalina package from the App Store. I started from Mojave so I never ran into the issues found in the comments. Check the comments for what Adam had to say...
** UPDATE 10/17/2019**
After applying the first update, the VM was rendered un-bootable again. That is the same crash that is originally experienced. SEE Boot Work Around at the bottom.
This exercise was to get a running MacOS Catalina VM instance running on VMware. I first wrote this for Catalina Beta but afte rthe official release, a couple things changed. So now it is how to install Catalina on ESXi 6.7.
I am using a 2013 Mac Pro with VMWare 6.7 U2 installed. I have High Sierra and Mojave VMs running on the host. Running VMs on VMware is something I've done for a few years.
A lot has changed in Catalina. Admittedly, I am not a MacOS expert. I'm not particularly good a Mac user either. So, I can't speak to the changes only that it is not currently (Oct 1, 2019) frienld to install on VMware ESXi. Catalina runs fine once you get a working VM though.

The MacOS Part

As of this writing (10/10/2019), You cannot upgrade and existing VM running High Sierra or Mojave. At least, I could not successfully upgrade and boot to Catalina.

If at first You Don't Succeed...

Note: You need to start at Mojave to upgrade to download the fill Catalina package.
I started with trying to upgrade a Mojave VM to Catalina. I just downloaded Catalina from the Apple Store (Search: macos catalina).
I followed the prompts and downloaded the Catalina installation image. I ran though the installation process which seemed to go pretty well. That is until it booted from the upgraded image. Then, it crashed. You can't see the crash, you just has an frozen Apple logo.

To see what is happening, reboot the VM and hold down the Windows Key + v for Verbose mode and see the boot attempt and the kernel panic. Changing VMware setting had no affect. After a couple hours, I gave up.

Try Something Else... And It Worked!

My next tack was to boot from a Catalina ISO. First, I had to create one. I'd done this before on Mojave so it wasn't all unfamiliar. The steps are below. I am not sure where they came from.
First, I had to boot back to Mojave. I had found by rebooting the VM to the Boot Manager settings (you can set this in the VM settings or press escape before the OS loads in a VM console) and Selecting the EFI VMware Virtual SATA Hard Drive (0,0) option (not Mac OS X), that boots to my original Mojave image.
To start from scratch on a Mojave instance, download Catalina from the app store (Search: macos catalina). Just don't run the installer. You need the app image to create the ISO.
Once Mojave loaded, to build the ISO file, I start by making the virtual disk:
hdiutil create -o /tmp/catalina -size 13000m -layout SPUD -fs HFS+J
Then, I mount it to I can copy the installer to it
hdiutil attach /tmp/catalina.dmg -noverify -mountpoint /Volumes/install_build
Now I copy the installer to the mounted image
sudo /Applications/Install macOS Catalina.app/Contents/Resources/createinstallmedia --volume /Volumes/install_build
The image is automatically mounted and is on your desktop. Select it and un-mount the image.
Now convert the image to an ISO file. You can put the file anywhere but I used ~/Downloads for simplicity
hdiutil convert /tmp/catalina.dmg -format UDTO -o ~/Downloads/catalina
Now rename the file from catalina.cdr to catalina.iso
mv ~/Downloads/catalina.cdr ~/Downloads/catalina.iso
You can delete /tmp/catalina.dmg.
Copy the ISO to your PC or where ever you want to attach it to the VM via a console session. I use WinSCP to copy to my PC.

The VMware Part

I created a blank VM with the following settings:
These are important. Just follow my lead here.
Guest OS Version: Apple macOS 10.14 64-bit
4GB Memory
The rest is default

Once the VM is saved, edit the settings and change to
Guest OS: Windows
Guest OS Version: Windows 10 64-bit
Changed to Windows 10

Next...
Open a Remote Console (VMRC)
Click VMRC --> Removeable Devices --> CD/DVD --> Connect to Disk Image File
Navigate to the catalina.iso file you saved where ever, Click Open
Attach ISO
Now ALT+CTRL+Insert in the VM to reboot it. It will boot from the ISO automatically. If not select the SATA CDROM frm the EFI menu. Note, sometimes it took several reboots for it to successfully boot from the ISO. usually, just one.

Once the installer image loads, use the disk tool to erase the VMware virtual disk (100GB in my case)
Use the default erase options (Note: Your keyboard doesn't work so just accept 'Untitled')Brew macos 11



Next, choose to install MacOS
Follow the install steps and install Catalina

Once the install finishes, it will reboot to the OS. Make sure you detach the ISO so you don't boot to the installer again.
Reset the VM
The VM should boot to the image and continue installing Catalina. When it finishes (10 or so minutes) it will reboot.


After the reboot, it will freeze on the blank Apple logo or unsuccessfully load MacOS X. Don't fret.. We're OK.
Power off the VM
Edit the VM setting and change the OS values.
Guest OS Version: Apple macOS 10.14 64-bit

Power on the VM and it will boot to and load Catalina.
Brew
Once you go through the setup steps and Catalina is ready to go.

Good luck on your adventure!

Added 10/17/2019
After applying the update, the VM was no longer booting. Same cast at boot with the Apple Logo and no progress.
the work around is to change the boot order in EFI boot settings to boot to SATA Hard Drive 0.0
You need to enter EFI boot configuration for the VM. You can hit escape a the VMware logo or go to the VM settings and set to boor to EFI next boot. Boot/reboot to get the EFI menu

Enter Setup
Configure Boot Options
Change Boot Order
Press Enter then change the boot order in the pop up window using + and - keys. Press Escape when done editing.
Move EFI Virtual SATA Hard Drive (0.0) to the Top
You can see I change the overall boot order to:

Brew Macos Big Sur Ca


Hard Drive
CDROM
Mac OS X
Press Enter to Commit changes and exit












If you came here looking how to install Xcode using brew (aka Homebrew), read this part first. Otherwise, skip to the introduction.

The solution depends on your answer to this question:

  • Are you planning on developing iOS or Mac applications?

If the answer is 'no', then you do not need Xcode. All you need are the standalone Command Line Tools, which you can install by reading this guide.

If the answer is 'yes', then you will need to download and install Xcode from the Apple App Store. Xcode is a Mac application built by Apple, and it cannot be installed with Homebrew.

Even if you answered 'yes', you will still need Homebrew and Ruby to install cocoapods, for example, so you should read this guide.

Introduction

After following many outdated and incomplete instructions for setting up a web development environment on a Mac (back in March 2012), and spending a lot of time finding solutions to the problems I encountered along the way, I decided to put together this detailed tutorial.

Over time, the tools got better, and ever since Mavericks, setting up a development environment on a Mac with Apple's standalone Command Line Tools, Homebrew, Git, a Ruby manager (such as chruby, rbenv, or RVM), Ruby, and Rails has been a fairly stress-free process that's no longer fraught with the issues I ran into in 2012.

In fact, the whole process can now be automated via the script that I wrote for you.

While it's certainly possible to set everything up manually, it's not as straightforward to explain because there are more options to consider in 2021. For example, the installation instructions will differ depending on your shell (Bash, zsh or fish), or if you are using a Mac with the Apple Silicon (M1) chip versus an Intel chip.

My script is smart enough to detect your current setup and install everything in the right place.

If you prefer to do everything manually, keep reading. This tutorial is kept up to date and is guaranteed to work in 2021.

Prerequisites

Supported macOS versions:

  • Big Sur
  • Catalina
  • Mojave
Brew Macos Big Sur

Your macOS software is up to date

Before you start, make sure you have the latest Apple software updates for your current macOS version. Check by going to System Preferences, then Software Update.

Homebrew is ready to brew

You can skip this section if you know you haven't tried to install Homebrew yet. If you're not sure, check the contents of the /usr/local folder (also check /opt/homebrew if you're on a Mac with the Apple Silicon chip). Run this command in the Terminal app:

If there's nothing in the folder, then you don't have Homebrew.

If you've already installed Homebrew, you'll want to make sure that when you run brew doctor, it says Your system is ready to brew.

If it's not ready to brew, one of the most common issues, and the first one you should fix, is missing or outdated Command Line Tools. The outdated tools message looks like this:

Here are other variations of the outdated message:

The missing tools message looks like this:

Homebrew usually provides detailed instructions for fixing things, so read carefully and follow their instructions. Quit and restart Terminal once the CLT are installed.

If you get errors other than the ones above, read through the Troubleshooting Homebrew section at the bottom of this guide.

You don't have RVM or rbenv installed

Back in 2012, I used to use RVM, but once I automated this process, RVM kept breaking my script, so I switched to the much simpler chruby and have been using it happily every since. chruby is not compatible with RVM and rbenv, so you'll need to uninstall them first.

Uninstall RVM

Then delete any lines related to RVM from these files if they exist:

  • ~/.bash_profile
  • ~/.zshrc
  • ~/.zprofile

Uninstall rbenv

Follow the rbenv uninstallation instructions, then delete any lines related to rbenv from these files if they exist:

  • ~/.bash_profile
  • ~/.zshrc
  • ~/.zprofile

If you don't know what the ~ means, or how to edit the files above, read my guide about how to open and edit hidden files (or dotfiles) on a Mac.

Installation

Notes on Terminal

Most of the work you'll be doing in this tutorial will be in the 'Terminal' application.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, start typing the first few letters of the app you are looking for, and once it appears, select it, and press return to launch it.

If you are on an M1 Mac, make sure Terminal is NOT in Rosetta mode.

You can check by running this command once Terminal opens:

It should say arm64 if you are on an M1 Mac.

Notes on your shell

This tutorials assumes you are using zsh. If you're not sure, read my guide to find out which shell you are using, and replace any references to .zshrc in the steps below with .bash_profile if you are using Bash.

Step 1: Install Homebrew and the Command Line Tools

Homebrew, 'the missing package manager for macOS,' allows you to easily install hundreds of open-source tools. The full installation instructions are available in the Homebrew Documentation, but you should only need to run the command that's listed at the top of the Homebrew site:

Note that the command listed on the Homebrew site could change, so please make sure that what I have listed above is the same. If it isn't, please let me know and I'll update it.

Copy and paste the command into your Terminal window, press return, then read what appears in the Terminal, and pay attention to any instructions that require your input. For example, Homebrew will prompt for your macOS password. Note that Terminal does not provide visual feedback when you type your password. Just type it slowly and press return.

Homebrew also automatically installs the Apple Command Line Tools, and it usually installs them in the background, but in case this changes, pay attention if any windows appear that require your input.

Once the installation is successful, quit and restart Terminal, then check if Homebrew is ready to go:

If you get Your system is ready to brew, you can move on to Step 2. Otherwise, read what Homebrew is saying very carefully. They usually provide great instructions that you should follow. If that doesn't help, go to the Troubleshooting section to learn how to fix errors and warnings you might run into.

On Apple Silicon Macs, Homebrew might tell you to run a few commands after the installation:

Quit and restart Terminal, then check if everything is working so far:

Step 2: Install chruby and the latest Ruby with ruby-install

Install chruby and ruby-install:

Install Ruby 2.7.2:

There is a newer version of Ruby (3.0.1), but it's not fully compatible with some gems such as Jekyll, so I recommend 2.7.2 to get started. You can always install any other available version of Ruby, in addition to 2.7.2. That's the advantage of using a Ruby manager like chruby. You can have multiple versions on your computer at the same time, and you can easily switch between them.

This will take a few minutes, and once it's done, configure your shell to automatically use chruby:

For Intel Macs

For Apple Silicon Macs

Quit and relaunch Terminal, then check that everything is working:

Brew Macos Big Sur

It should say ruby 2.7.2p137.

Step 3: Configure Rubygems

Disable downloading documentation when install gems (for faster installation):

Make sure Rubygems is up to date:

Step 4: Install and configure Bundler

Install Bundler:

Configure Bundler to take advantage of your computer's cores:

Step 5: Install any other gem you want

Congrats! You now have a working Ruby development environment. You should now be able to installs Rails, or Jekyll, or whatever gem you've been trying to install for the past few days!

Macos Big Sur Release Date

If you got any value out of my tutorial, join the 1200+ people who are becoming confident coders through my quality guides and exclusive content in my free newsletter.

Step 6: Install Git

Git is the version control system of choice among many web developers. With Homebrew, installing Git is as easy as this:

Since we just installed Homebrew, we could have skipped brew update, but it's a good habit to run it before installing anything with Homebrew because Homebrew is updated regularly.

Quit and relaunch Terminal, then verify the Git installation:

You should get git version 2.31.1 or later.

Next, you'll need to configure Git with your name and email, and other important settings.

Next Steps

Once you start coding away on your computer, you will most likely need to install more tools with Homebrew. Before you do, remember to always run brew update and brew doctor to make sure your system is still ready to brew. To upgrade your existing packages, run brew upgrade. It's important to keep your development environment up to date, and Homebrew is just one of the tools you need to remember to update.

Knowing when and how to automate is a sign of an effective engineer. Most things you do repeatedly will add up to a lot of wasted time if you don't find ways to speed them up.

That's why I recommend taking advantage of my script, which allows you to keep your system up to date by typing a single word in your Terminal. It does that by adding an alias, which is a shortcut for the longer command. If you're not familiar with aliases, read my guide about how aliases can speed up your workflow.

Troubleshooting Homebrew warnings and errors

Consider starting over from scratch

Before you start looking through this list and trying to fix every warning and error, I would suggest a quick and easy solution: uninstall Homebrew and start over from scratch.

Before you do that, take a screenshot or copy and paste in a text file the list of tools you currently have installed:

If you installed a database with Homebrew (such as Postgres), and stored data that you need, back it up first. It is unusual to have important data stored in a local database and nowehere else, but I'll mention it for completeness.

Then uninstall Homebrew:

This will not completely remove all Homebrew folders, so you'll need to finish the job:

This will prompt you for your macOS password, and then it will say:

This is expected because you can't delete the /usr/local folder itself, but you can delete anything inside it. On a brand new Mac, the /usr/local folder already exists, but it is empty.

To verify that Homebrew was completely removed, check the contents of the /usr/local folder:

It should be empty.

Then go back to step 1, and after you complete this tutorial, run brew list again, and install any missing tools. If you don't recognize the missing tools, or if all your coding projects are still working, then you don't need to install them.

Fix brew issues one by one

In many cases, Homebrew will provide helpful instructions for dealing with warnings and errors, and I usually follow those instructions. I've tried to cover the most common sources of warnings and errors.

If you run into an issue I haven't mentioned, try looking it up in the Homebrew GitHub Issues, or search for the error message on DuckDuckGo. If that doesn't help, subscribe to my newsletter and I'll do my best to help you.

After you fix each issue, run brew doctor until you get Your system is ready to brew. Then go to Step 2.

Sur

PATH issues

If you get Warning: /usr/bin occurs before /usr/local/bin, run the command below (as recommended by Homebrew), and quit and relaunch Terminal:

Read my guide about PATH to understand why this is important.

Other similar PATH issues you might see:

Missing directory errors

sudo allows you to run commands as a user with higher access rights, which is why it prompts you for your password, and mkdir stands for 'make directory.'

chown stands for 'change owner,' the -R flag applies this to all nested files and directories, and whoami is a variable that represents your macOS username. You should copy and paste the commands above as is.

Permission errors

If you get /usr/local/etc isn't writable or Cannot write to /usr/local/Cellar or if it complains that any directories inside /usr/local aren't writable, fix it with this command:

This makes you the owner of the /usr/local directory, in addition to all nested directories.

Unbrewed files

Here are examples of common warnings about unbrewed files:

If you get a warning about any type of unbrewed file (such as .pc files, or static libraries), you may need to delete them as suggested by Homebrew (unless you put them there on purpose, which is unlikely). You'll have to delete each file it complains about one by one with the rm command. For example, to remove a file called libgd.2.0.0.dylib from /usr/local/lib, you would run this command:

In some cases, it might list a bunch of files that are all in the same directory, as in this example where something went wrong when installing Node:

In this case, you can delete the entire directory that contains the unbrewed files:

Python warnings and config scripts

A related issue is:

These most likely mean you installed Python with a tool other than Homebrew. If you think you might need this version of Python, then just ignore those warnings. Otherwise, run the command below to remove that version of Python, but read this thread first.

In general, you want to install all development tools with Homebrew.

Outdated or misconfigured Xcode

Unless you plan on building iOS or Mac applications, you don't need Xcode. All you need are the standalone Command Line Tools, which are installed when you follow this tutorial. If you already installed Xcode, you can safely delete it (again, assuming you haven't used it and don't plan to use it).

So, if you get any of the errors below, delete Xcode, then run brew doctor.

Outdated Xcode

Misconfigured Xcode

Linking keg-only formula

Homebrew messages are generally very helpful and they let you know exactly what to do. In this case, it is telling you to fix the linking issue by running brew unlink, followed by the tools (or 'brews') that need to be unlinked. Here, there is only one tool that needs to be unlinked. Therefore, you should run this command:

If it listed more than one tool, you would add them to the command separated by a space, like so:

Unlinked kegs

Broken symlinks

Use brew cleanup to fix these types of warnings:

Deprecated taps

In this case, you need to add the specific cask to the brew untap command, such as:

Missing dependencies

The instructions here are straightforward:

Issues with the Git repo

Follow the instructions:

Prefix issues on Apple Silicon

This is caused if you installed Homebrew while running your terminal in Rosetta mode, and are now running it in native mode, or if you used arch -x86_64 while in native mode, or other types of mixing the two environments.

Brew Macos Big Sur Release Date

Most things you need for Ruby web development are supported in native mode now, so there's no need to use Rosetta anymore. For more details and things to look out for, read my guide on installing a development environment on Apple Silicon.