New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Note on installing couchapp on OS X Sierra #240

merged 3 commits into from Nov 29, 2016


None yet
2 participants

iblis17 commented Nov 22, 2016

Just posting this note for other non-Python people who attempt to install Couchapp on OS X Sierra:

The installation instructions didn't work for me the way they were posted on the README. Due to SIP, pip install couchapp, or even sudo pip install couchapp will fail. In order to install it successfully, you need to run pip install --user couchapp

In addition to this, once couchapp is "installed" you need to add it to your PATH (~/.bash_profile for me) so you can use it via the command line. You have to track down the binary in your file system in order to determine the right path to include.

For me, with a vanilla Sierra environment and built-in Python, the couchapp binary was located at: ~/library/python/2.7/bin/couchapp However, your mileage may vary. To verify where your pip installed it, type pip show --files couchapp, and note the location of the first file that's listed. For me, this was a relative path (../../../bin/couchapp) with respect to ~/library/python/2.7/lib/python/site-packages. The absolute path was thus ~/library/python/2.7/bin/couchapp

So, I had to add the following line to my ~/.bash_profile (which I also had to create, since it doesn't exist by default in Sierra):

export PATH=$PATH:~/library/python/2.7/bin/couchapp

If you use a command-line text editor to create and save this file, remember to open a new Terminal window (i.e. start a new session) before running couchapp, or it still won't work and you'll be confused as to why.

Hope this helps somebody in the future. Thanks to rnewson and damjam on IRC for their assistance.


This comment has been minimized.


iblis17 commented Nov 22, 2016


This comment has been minimized.


iblis17 commented Nov 22, 2016

Or any note about macOS package? I do not have any macOS machine...

@iblis17 iblis17 force-pushed the iblis17:issue-240 branch from c0112c3 to 96f89d9 Nov 22, 2016

@iblis17 iblis17 merged commit 2226934 into couchapp:master Nov 29, 2016

@iblis17 iblis17 deleted the iblis17:issue-240 branch Nov 29, 2016


This comment has been minimized.

zachsa commented Dec 15, 2016

I found that the line I had to add to my .bash_profile file was export PATH=$PATH:~/library/python/2.7/bin/.

Thank you very much for the help

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment