How to install Solana dev tools on an M1 Mac

If you're just getting started with Solana development on a new M1 Mac, you might be pulling your hair out right now. Everything was going great as you followed along with Solana's official install guides and ran the solana CLI command for the first time... but as soon as you tried to spin up a validator using the solana-test-validator command, you ran into this error message:

dyld: Library not loaded: /usr/local/opt/openssl@1.1/lib/libssl.1.1.dylib
  Referenced from: /Users/123/.local/share/solana/install/active_release/bin/solana-test-validator
  Reason: image not found
zsh: abort      solana-test-validator

Maybe you read the error message, got clever and installed OpenSSL… only to run into a different error message:

Ledger location: test-ledger
Log: test-ledger/validator.log
⠁ 
zsh: illegal hardware instruction  solana-test-validator

🧐😕

The problem here is that the Solana dev tools were written for Intel-based x86 chips while the new M1 Macs use an ARM-based architecture. The solution here isn't to sell your shiny new Macbook or pull out an old laptop. Luckily we can use a handy tool called Rosetta to re-compile Solana from the source code in a way that will run on Apple silicon.

1. Start fresh

If you've already tried to set up your environment following Solana's guides, the first thing to do is uninstall everything and start over from scratch.

Begin by locating the Terminal app in Finder, and use the ⌘I keystroke to open Finder's Inspector window. Make sure the Open using Rosetta option is disabled and restart your Terminal.

Now we can go ahead and cleanly uninstall everything. Let's first uninstall Solana:

rm -rf /Users/USERNAME/.local/share/solana/

And then uninstall Rust:

rustup self uninstall

2. Set up Rosetta

Once you've uninstalled Solana and Rust, your local dev environment will be in a clean state to start over. Let's begin this time by first installing Rosetta:

/usr/sbin/softwareupdate --install-rosetta --agree-to-license

Now navigate back to your Finder window and create a duplicate copy of the Terminal application.

We're going to create two versions of Terminal: one that uses Rosetta and one that doesn't. I recommend naming the duplicate Terminal instance to Terminal Rosetta so it's always clear which version you're using.

To enable Rosetta in the Terminal Rosetta version, use the ⌘I keystroke again to pull up Finder's Inspector window and make sure the Open using Rosetta option is enabled.

From here on out, we're only going to use the Terminal Rosetta app, so I recommend either closing or minimizing your existing Terminal windows to avoid getting them mixed up. Go ahead an open a Terminal Rosetta window for the next section.

3. Install dependencies

Let's dive in and install all the dependencies Solana will need to get running. In a Terminal Rosetta shell, run the following command to install Rust:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Next, let's install Homebrew. Note our command starts with the arch -x86_64 prefix. This tells Rosetta to execute the following command using the x86 instruction set.

arch -x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

Let's also install Coreutils and OpenSSL:

arch -x86_64 brew install coreutils openssl@1.1

Now we need to set up a config file so Cargo knows how to compile Rust code for our machine. Create a new file at ~/.cargo/config and paste in these build configs:

[target.x86_64-apple-darwin]
rustflags = [
  "-C", "link-arg=-undefined",
  "-C", "link-arg=dynamic_lookup",
]

[target.aarch64-apple-darwin]
rustflags = [
  "-C", "link-arg=-undefined",
  "-C", "link-arg=dynamic_lookup",
]

4. Install and build Solana

Navigate to a stable directory where you can save the Solana source code. For example, I use an umbrella folder for all my projects at ~/Developer.

Clone the Solana repo and then move into the Solana directory:

git clone https://github.com/solana-labs/solana.git
cd solana

Now let's use Cargo to compile the Solana source code:

cargo build

Next run the install script. This will take a little while, so feel free to go grab a coffee while you wait.

./scripts/cargo-install-all.sh .

Finally, update your PATH so Terminal knows where to find the Solana CLI commands:

export PATH=$PWD/bin:$PATH

5. Play around!

If you've made it this far, congratulations! You've successfully downloaded the Solana source code and used Rosetta to compile it to run on your M1 Mac.

Let's verify everything is working as expected. First make sure you can use the Solana CLI command:

solana

And now for the moment of truth, let's spin up a local test validator!

solana-test-validator

If everything is configured correctly, the validator will start running and print out its status like this:

You now have a Solana validator running on your local machine and can run commands like solana balance and solana transfer to submit transactions to your own personal devnet.

Notes

If you run into any issues while following this guide, please let me know in the comments or DM me on Twitter so I can publish a revision. Can't wait to see what you build!

Comments

[Prashant Dandriyal]

Hi Nick. Kudos for the good work. Just wanted to point out that while installing arch -x86_64 brew install openssl@1.1 on the rosetta terminal, I got this brew error:

Error: Cannot install under Rosetta 2 in ARM default prefix (/opt/homebrew)!
To rerun under ARM use:
    arch -arm64 brew install ...
To install under x86_64, install Homebrew into /usr/local.

I don't know why this wasn't experienced by anybody else. I am looking into this and would like to know if someone already solved it. 🤠

[Abhijit Roy]

Finally! I resolved this issue. Now, I am able to start a localnet node in my Mac M1.

From this step where, you are stuck, just continue installing under ARM architecture. Then, follow my notes here. github.com/abhi3700/sol-playground...

You will be able to run on M1. I tested for Solana version 1.8.5.

[Abhijit Roy]

Even I am facing this same issue.

Would like to hear from reply from others

[Mizi San]

I wasn't able to run ./scripts/cargo-install-all.sh .

[Sitt Guruvanich]

According to this commit on Solana repo, I think you need to install greadlink first using the following command

arch -arm64 brew install coreutils

[Luca Cervone]

at line 13 of cargo-install-all.sh

change this:

cargo="$("${readlink_cmd}" -f "${here}/../cargo")"

to this:

cargo="cargo"

then run

./scripts/cargo-install-all.sh .

It should work

[saturn]

For anyone who might encounter this, after editing the cargo-install-all.sh file I would get:
zsh: operation not permitted: ./scripts/cargo-install-all.sh
Apple apparently puts the file in quarantine, running
xattr -d com.apple.quarantine solved it !

[Luca Cervone]

anyway, do not use

git clone https://github.com/solana-labs/solana.git

Since it will download the current version of Solana, that right now (November, the 7th 2021), is the 1.9.0. Even if this version will build and install correctly on M1 macs, you'll have issues later when you try to send transactions to the Solana network.

Instead, download the 1.8.2 version and follow all the above steps.

[robbie white]

I am at the point where I have to setup config file so Cargo knows how to compile Rust codes, I did not have a folder named config so I created that, then in that folder I created a file and named it rust code and pasted the given code in. and when I run cargo build I get an error saying it could not find cargo.toml
Am i doing something wrong?

[robbie white]

ok so i figured it out, you do not make a folder, you just make the file and name it config. so that fixed that.

[dige93]

MacBook-Pro ~ % solana-test-validator
dyld[19265]: Library not loaded: /usr/local/opt/openssl@1.1/lib/libssl.1.1.dylib
Referenced from: /Users/dige/.local/share/solana/install/releases/1.8.5/solana-release/bin/solana-test-validator
Reason: tried: '/usr/local/opt/openssl@1.1/lib/libssl.1.1.dylib' (no such file), '/usr/local/lib/libssl.1.1.dylib' (no such file), '/usr/lib/libssl.1.1.dylib' (no such file)
zsh: abort solana-test-validator

Can't find a solution to this.

[robbie white]

I am having a problem with the updating my path, I went to the .zshrc and added the given path and it when I do the last step to see if solana is working I get and error saying command not found. any help or ideas of what I may have done wrong?

[CSJcode]

I'm using bash but just did the following and it worked fine, should work if you fill in ~/.zshrc:

echo 'export PATH=$PWD/bin:$PATH' >> ~/.bash_profile

[CSJcode]

Thank you for taking the time and effort to do this. This was very helpful fixing validator errors after I got my new M1 mac. I did have to do some additional minor config edits, such as suggested by Luca Cervone in the discussion here... but your article got me 95% there. Thanks!

[indieRepublik]

I tried to run the solana-test-validator and got message: Notice! No wallet available. solana airdrop localnet SOL after creating one

Ledger location: test-ledger
Log: test-ledger/validator.log
⠁ Initializing... zsh: illegal hardware instruction solana-test-validator

[Ocean&Sky]

Hi newbie in solana dev here, I got stuck at step "cargo build" (after compiling solana source code) receiving error: failed to run custom build command for tikv-jemalloc-sys v0.4.2+5.2.1-patched.2

Here's my current rust and other dependencies version and using Mac M1 hardware.

I also tried to use sudo apt update but no avail. However on this site substrate.stackexchange.com/questi..., i found answer that suggesting to manually update to current version of tikv-jemalloc-sys, maybe this can be a solution but no knowledge on how to do that.

[Nimish]

I am able to run solana-test-validator but when I open other terminal to execute solana commands it gives "-bash: solana: command not found". Could someone please help here?
Also if I close the terminal and start again, I have to do all the steps again.

[Thorsten Hirsch]

Thanks for the tutorial. I would only change one step: install Rust with Homebrew.

[Danny Geisz]

Excellent post! low-key a life saver

[Luca Cervone]

THANK YOU!

[Payton]

Love this. Thank you SO much!

[Elshore梦]

I can't thank you enough.