Page MenuHomePhabricator

D3536.id10970.diff
No OneTemporary

D3536.id10970.diff

diff --git a/docs/dev_environment.md b/docs/dev_environment.md
--- a/docs/dev_environment.md
+++ b/docs/dev_environment.md
@@ -561,6 +561,20 @@
This script will create the `server/secrets/olm_config.json` config file.
+## Python 2 (Apple silicon Macs)
+
+For Apple silicon Macs, Python 2.7 is a requirement.
+
+We need Python 2.7 because the `sqlite3` NPM package doesn't come with prebuilt ARM64 binaries and requires a native build that depends on Python 2 scripts.
+
+Up until macOS 12.3, Python 2.7 was "included in macOS for compatibility with legacy software." However, if your machine is running macOS 12.3 or later, you'll need to install Python 2.7 manually.
+
+Download the Python 2.7.18 64-bit macOS installer from the [Python.org release page](https://www.python.org/downloads/release/python-2718/) and follow the installation steps provided.
+
+The reason we need Python 2.7 on Apple silicon Macs is because the `sqlite3` NPM package doesn't come with prebuilt ARM64 binaries and requires a native build that depends on Python 2 scripts.
+
+Installing Python 2.x via Homebrew is no longer officially supported. Instead, download and install the Python 2.7.18 64-bit macOS installer from the [Python.org release page](https://www.python.org/downloads/release/python-2718/).
+
## Phabricator
The last configuration step is to set up an account on Phabricator, where we handle code review. Start by [logging in to Phabricator](https://phabricator.ashoat.com) using your GitHub account.

File Metadata

Mime Type
text/plain
Expires
Thu, Nov 28, 5:21 AM (20 h, 45 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
2592872
Default Alt Text
D3536.id10970.diff (1 KB)

Event Timeline