paulmataruso/zulip
1
0
Fork 0
mirror of https://github.com/zulip/zulip.git synced 2025-10-23 04:52:12 +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
```
:::{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
does the following: