The official documentation has moved to http://docs.couchdb.org — The transition is not 100% complete, but http://docs.couchdb.org should be seen as having the latest info. In some cases, the wiki still has some more or older info on certain topics inside CouchDB.

You need to be added to the ContributorsGroup to edit the wiki. But don't worry! Just email any Mailing List or grab us on IRC and let us know your user name.

Installing on Fedora Core 10 x86_64

1. build and install Erlang

Erlang can be downloaded from http://www.erlang.org/download.html. Build instructions can be found here: http://www.erlang.org/doc/installation_guide/INSTALL.html#id54376

Note : I was able to build Couchdb 1.2.0a1056082 using Erlang R14B01 Tips: you'll need ncurses and openssl devel packages

2. install other dependencies (no external repos required).

  # yum install icu libicu-devel js js-devel libcurl-devel

Note : this results in icu version 4.0-3.fc10 and js version 1.70-3.

3. install couchdb

The code can be gotten from subversion using

  $ svn checkout http://svn.apache.org/repos/asf/couchdb/trunk couchdb
  $ cd couchdb
  $ ./bootstrap

If bootstrap throws "libtoolize: command not found" you need to "# yum install libtool"

  $ ./configure

If configure throws "Could not find the `erl_driver.h' header" you need to tell it where the Erlang includes are; for example: "--with-erlang=/usr/lib64/erlang/usr/include/".

And then as root:

  # make install

The source can also be obtained from a released version using a tool like wget. The example uses the primary site, whereas it is often faster to download from a mirror, e.g.,

For example,

  $ wget http://www.apache.org/dist/incubator/couchdb/0.8.1-incubating/apache-couchdb-0.8.1-incubating.tar.gz
  $ tar -xzvf apache-couchdb-0.8.1-incubating.tar.gz 
  $ cd apache-couchdb-0.8.1-incubating
  $ ./configure  --with-erlang=/usr/lib64/erlang/usr/include/
  $ make && make install

4. create couchdb user

  $ sudo adduser -r -d /usr/local/var/lib/couchdb couchdb
  $ sudo chown -R couchdb /usr/local/var/lib/couchdb
  $ sudo chown -R couchdb /usr/local/var/log/couchdb

5. (optional) edit basic settings like Port and BindAddress

  $ emacs /usr/local/etc/couchdb/couch.ini

6. start CouchDB server in your terminal

  $ cd /usr/local/bin/
  $ sudo -u couchdb ./couchdb

or as daemon

  $ sudo /usr/local/etc/rc.d/couchdb start

Access

or

if you edited the BindAddress

Installing_on_Fedora10 (last edited 2011-11-23 14:33:44 by JanLehnardt)