diff --git a/docs/newbs_getting_started.md b/docs/newbs_getting_started.md index 99aee121397..91bfa083102 100644 --- a/docs/newbs_getting_started.md +++ b/docs/newbs_getting_started.md @@ -56,11 +56,17 @@ QMK maintains a Homebrew tap and formula which will automatically install the CL You will need to install Homebrew. Follow the instructions on https://brew.sh. +!> **NOTE:** If you are using Apple Silicon, such as the M1, you will need to install a rosetta compatible version of Homebrew. This version does not override the base Homebrew. This can be done by running `arch -x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"`. See here: [Rosetta-compatible Homebrew](https://stackoverflow.com/questions/64882584/how-to-run-the-homebrew-installer-under-rosetta-2-on-m1-macbook) + #### Installation Install the QMK CLI by running: brew install qmk/qmk/qmk + +Install the QMK CLI on an Apple Silicon Mac by running: + + arch -x86_64 brew install qmk/qmk/qmk ### ** Linux/WSL **