docs: troubleshoot macOS with ARM64 architecture (#8560)

Merge pull request 8560
jekyll · Mar 29, 2021 · 63ce7d6 · 63ce7d6
1 parent f5a137d
commit 63ce7d6
Showing 1 changed file with 9 additions and 0 deletions.
diff --git a/docs/_docs/troubleshooting.md b/docs/_docs/troubleshooting.md
@@ -208,6 +208,15 @@ you don't have a proper JavaScript runtime. To solve this, either install
 
 ## Problems running Jekyll
 
+### macOS
+
+Jekyll is compatible with macOS with ARM64 architecture.
+However, `bundle exec jekyll serve` may [fail with elder version `ffi`](https://github.com/ffi/ffi/issues/870).
+
+You may need to run `bundle update` or update `ffi` to at least `1.14.2` manually.
+
+### Debian or Ubuntu
+
 On Debian or Ubuntu, you may need to add `/var/lib/gems/1.8/bin/` to your path
 in order to have the `jekyll` executable be available in your Terminal.