1. Installation

The newest install instructions are always in the README

In case the below is not updated, check out the release section in GitHub.

Requirements

  • Python 2.x >= 2.6 (Python 3.x will be supported soon)
  • the header files of the Python version that is used, which are included e.g. in the according development package python-dev (may have a different name depending on your system)

Installing on all UNIXs

To install couchapp using easy_install you must make sure you have a recent version of distribute installed:

$ curl -O http://python-distribute.org/distribute_setup.py
$ sudo python distribute_setup.py
$ sudo easy_install pip

To install or upgrade to the latest released version of couchapp:

$ sudo pip install couchapp
$ sudo pip install --upgrade couchapp

To install/upgrade development version:

$ sudo pip install git+http://github.com/couchapp/couchapp.git#egg=Couchapp

Installing in a sandboxed environnement

If you want to work in a sandboxed environnement which is recommended if you don’t want to not pollute your system, you can use virtualenv :

$ curl -O http://python-distribute.org/distribute_setup.py
$ sudo python distribute_setup.py
$ easy_install pip
$ pip install virtualenv

Then to install couchapp :

$ pip -E couchapp_env install couchapp

This command create a sandboxed environment in couchapp_env folder. To activate and work in this environment:

$ cd couchapp_env && . ./bin/activate

Then you can work on your couchapps. I usually have a couchapps folder in couchapp_env where I put my couchapps.

Installing on Mac OS X

Warning

This section is out-of-date. We need you help for testing on newer OSX with newer couchapp.py

Using CouchApp Standalone executable

Download couchapp-1.0.0-macosx.zip on Github then double-click on the installer.

Using Homebrew

To install easily couchapp on Mac OS X, it may be easier to use Homebrew to install pip.

Once you installed Homebrew, do:

$ brew install pip
$ env ARCHFLAGS="-arch i386 -arch x86_64" pip install couchapp

Installing on Ubuntu

Warning

Our PPA is out-of-date. We need your help for upgrading the packages.

If you use Ubuntu, you can update your system with packages from our PPA by adding ppa:couchapp/couchapp to your system’s Software Sources.

Follow instructions here.

Installing on Windows

There are currently 2 methods to install on windows:

Previous Release

Please check out both release section and download section in GitHub.

Note that the download section in GitHub is deprecated.