From e962704c716ff4566285ec5dafdaee9c2ceed8ae Mon Sep 17 00:00:00 2001 From: Vikas Parashar Date: Wed, 5 Oct 2016 23:47:55 +0530 Subject: [PATCH] Add installation troubleshooting instructions in case of pip failure. Add help for pip install failure during provisioning step of initial vagrant up during developer environment installation. Fixes: #1333. --- docs/dev-env-first-time-contributors.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/docs/dev-env-first-time-contributors.md b/docs/dev-env-first-time-contributors.md index 9d35240fe1..a79995f75c 100644 --- a/docs/dev-env-first-time-contributors.md +++ b/docs/dev-env-first-time-contributors.md @@ -648,7 +648,18 @@ Finally, if you encounter any issues that weren't caused by your Internet connection, please report them! We try hard to keep Zulip development environment provisioning free of bugs. -#### npm install error +##### `pip install` fails during `vagrant up` on Ubuntu + +Likely causes are: + +1. Networking issues +2. Insufficient RAM. Check whether you've allotted at least two +gigabytes of RAM, which is the minimum Zulip +[requires](dev-env-first-time-contributors.html#requirements). If +not, go to your VM settings and increase the RAM, then restart +the VM. + +##### npm install errors The `tools/provision.py` script may encounter an error related to `npm install` that looks something like: