diff --git a/docs/_docs/troubleshooting.md b/docs/_docs/troubleshooting.md
index e1d6fa0a..02b79ae1 100644
--- 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.