Skip to content

Commit 4c3e31b

Browse files
committed
Add instructions for ceating env on Apple Silicon
1 parent 636443f commit 4c3e31b

File tree

1 file changed

+29
-3
lines changed

1 file changed

+29
-3
lines changed

docs/quickstart.md

Lines changed: 29 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@ Check your system documentation for how to launch interactive compute sessions
6666
E3SM-Unified is not officially supported on Linux or Mac laptops or
6767
workstations, but users can install it using `miniforge3`.
6868

69-
### Step-by-Step (Linux/macOS):
69+
### Step-by-Step (Linux):
7070

7171
```bash
7272
# Install miniforge3
@@ -79,10 +79,36 @@ conda create -n esm-unified -c conda-forge e3sm-unified
7979
# Activate it
8080
conda activate e3sm-unified
8181
```
82+
**Note**: The above instructions also work for macOS machines with intel hardware.
8283

83-
Note: On macOS with M1/M2 chips, install the x86\_64 version and use Rosetta 2
84-
for compatibility.
84+
### Step-by-Step (macOS with Apple Silicon)
8585

86+
```bash
87+
# starts a shell in "Rosetta" mode
88+
arch -x86_64 /bin/bash --login
89+
90+
# create the conda-environment to install e3sm-unified within
91+
CONDA_SUBDIR=osx-64 conda create -n e3sm-unified python=3.10
92+
93+
# activate the environment and set an environmental variable
94+
conda activate e3sm-unified
95+
conda env config vars set CONDA_SUBDIR=osx-64
96+
97+
# deactivate and re-activate the environment for the above command to propagate
98+
conda deactivate
99+
conda activate e3sm-unified
100+
101+
# now you can actually install e3sm-unified
102+
conda install -c conda-forge e3sm-unified
103+
104+
# exit the "Rosetta" mode shell
105+
exit
106+
```
107+
108+
**Checking if you macOS machine has Apple Silicon**:
109+
1. Click the Apple menu at the top-left of your screen.
110+
2. Select "About This Mac": from the dropdown menu.
111+
- If you see "Chip" followed by M1, M2, M3, or M4, your Mac has Apple silicon.
86112
---
87113

88114
## Related Pages

0 commit comments

Comments
 (0)