From 63ce7d66bfd65a4db27cbb0f9b55dea03f8964c8 Mon Sep 17 00:00:00 2001 From: David Zhang Date: Mon, 29 Mar 2021 20:56:06 +0800 Subject: [PATCH] docs: troubleshoot macOS with ARM64 architecture (#8560) Merge pull request 8560 --- docs/_docs/troubleshooting.md | 9 +++++++++ 1 file changed, 9 insertions(+) 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.