paulmataruso/zulip
1
0
Fork 0
mirror of https://github.com/zulip/zulip.git synced 2025-10-26 17:43:58 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: Add warning about failed provisioning on macOS.

Browse Source 
Fixes: #28370
This commit is contained in:
Karl Stolley
2024-01-04 11:03:00 -06:00
committed by Tim Abbott
parent 0c8730a723
commit 131c24b390
1 changed files with 10 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/development/setup-recommended.md
View File

@@ -314,6 +314,16 @@ cd zulip
vagrant up --provider=docker vagrant up --provider=docker
``` ```
:::{warning}
There is a [known upstream issue on macOS](https://chat.zulip.org/#narrow/stream/21-provision-help/topic/provision.20error.20ERR_PNPM_LINKING_FAILED/near/1649241)
that can cause provisioning to fail with `ERR_PNPM_LINKING_FAILED` or other errors. The temporary
fix is to open the Docker desktop app's settings panel, and choose `osxfs (legacy)` under "Choose
file sharing implementation for your containers." Once Docker restarts, you should be able to
successfully run `vagrant up --provider=docker`. Back in Docker, you can return to using VirtioFS
for better system performance while developing, but you may need to revert to `osxfs (legacy)`
whenever you need to re-provision.
:::
The first time you run this command it will take some time because Vagrant The first time you run this command it will take some time because Vagrant
does the following: does the following: