If you’re unfortunate enough to need to connect to an Oracle database using Ruby, you will be familiar with the woes of having to install Oracle Instant Client to be able to use the Ruby OCI8 gem. I have always found this fiddly and it was made yet more fiddly when I started using an M1 Mac last year.
Oracle have yet to release a version of Instant Client that is compatible with M1 arm64 chipsets which means if you need to use this gem, it needs a version of Ruby which has been compiled with Intel architecture.
This post will guide you through compiling a version of Ruby in Intel architecture (x86_64) instead of the new default Apple architecture (arm64).
Install Rosetta2, which enables x86_64 compiled code to be run on arm64 M1 processor.
/usr/sbin/softwareupdate --install-rosetta --agree-to-license
First check whether your Brew is installed in arm64 or x86_64 architecture. If you installed Brew normally it is likely to be arm64.
# arm64 location: /opt/homebrew/bin/brew
# x86_64 location: /usr/local/Homebrew/bin/brew
If your brew is installed in the x86_64 location skip to step 4, otherwise carry on.
arch --x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
This will install another instance of brew in
/usr/local/ which is the x86_64 location, leaving your existing arm64 Brew
in place in
In order to easily switch between running commands using the two versions of Brew, I setup an alias. Add the following to your .zshrc or relevant terminal config. I decided to call mine ibrew short for Intel Brew. You can call it something else if you want.
alias ibrew='arch --x86_64 /usr/local/Homebrew/bin/brew'
# check if xcode is installed
# install xcode-select if not installed
# install key dependencies for compiling Ruby using our new Intel Brew
ibrew install openssl readline libyaml zlib bison firstname.lastname@example.org
# install any other dependencies you know your gems will need, e.g. if you're using pg or mysql.
ibrew install libpq mysql
Set these environment variables before installing Ruby to tell it where the key dependencies are installed.
export PATH="$(ibrew --prefix email@example.com)/bin:$PATH"
export RUBY_CONFIGURE_OPTS="--with-openssl-dir=$(ibrew --prefix firstname.lastname@example.org) --with-readline-dir=$(ibrew --prefix readline) --with-libyaml-dir=$(ibrew --prefix libyaml) --with-zlib-dir=$(ibrew --prefix zlib)"
Choose one of the below, which ever is your Ruby version manager of choice:
arch -x86_64 asdf install ruby <version>
arch -x86_64 rbenv install <version>
First try to run the install again, sometimes it installs correctly on the second attempt. If the retry does not work:
After an update to xcode on 4th November 2022, I could no longer install any Ruby version. Following this guidance, I had to downgrade xcode to version 13 for it to work.
Mysql2 gem is troublesome but the comment and steps here seem to allow the gem to build.
If pg gem fails to install stating missing libraries, try installing the gem with the pg_config of the Intel installed libpq library.
gem install pg -v '<pg_version_of_project>' -- --with-pg-config=/usr/local/opt/libpq/bin/pg_config
If the rdkafka gem fails to install, try setting the flags for openssl
and lz4 before installing the gem. To check these paths are correct for
your machine you can run
ibrew --prefix email@example.com and
ibrew --prefix lz4
export LDFLAGS="-Lfirstname.lastname@example.org/lib -L/usr/local/opt/lz4/lib"
gem install rdkafka
That’s about all the tips I can give you based on my experiences of using this Gem on my M1 since last year, let me know if it still doesn’t work for you or if there’s anything missing from this set of instructions.