Dear Wiki user, You have subscribed to a wiki page or wiki category on "Couchdb Wiki" for change notification.
The "Installing_on_Ubuntu" page has been changed by DaveCottlehuber: http://wiki.apache.org/couchdb/Installing_on_Ubuntu?action=diff&rev1=78&rev2=79 Comment: bump ubuntu build steps for current 12.* releases [PLEASE CHECK] <<Include(EditTheWiki)>> + <<TableOfContents(2)>> + = Ubuntu-provided CouchDB = - == Batteries Included == - Newer versions of Ubuntu have CouchDB included in their respective software repositories. You can install CouchDB with the '''Ubuntu Software Center''', or from the command line with the '''apt-get''' or '''aptitude''' utilities, which ever you prefer. However, to get the newest version of CouchDB you may have to install from source, or other package repositories that have newer pre-built CouchDB packages. - As of July 2012 modern package repositories only have [[https://apps.ubuntu.com/cat/applications/precise/couchdb/|CouchDB v1.0.1]] and not v1.2.0, which is highly recommend over 1.0.1. To install 1.2.0 please see the build-couchdb section below. + Depending on your Ubuntu release, [[https://apps.ubuntu.com/cat/applications/couchdb/|CouchDB availability]] varies. Newer versions of Ubuntu have a recent CouchDB included in their respective software repositories. You can install CouchDB with the '''Ubuntu Software Center''', or from the command line with the '''apt-get''' or '''aptitude''' utilities, which ever you prefer. However, to get the newest version of CouchDB you may have to install from source, or other package repositories that have newer pre-built CouchDB packages. + + ||'''Ubuntu Release''' ||'''CouchDB Version'''||'''Recommendation''' || + || [[https://apps.ubuntu.com/cat/applications/quantal/couchdb/|Quantal|12.10]] || CouchDB 1.2.0 || Install Package || + || [[https://apps.ubuntu.com/cat/applications/precise/couchdb/|Precise|12.04]] || CouchDB 1.2.0 || Install Package || + || [[https://apps.ubuntu.com/cat/applications/oneiric/couchdb|Oeniric 11.10]] || CouchDB 1.0.1 || Build from Source || + || [[https://apps.ubuntu.com/cat/applications/natty/couchdb/|Natty 11.04]] || CouchDB 1.0.1 || Build from Source || + || [[https://apps.ubuntu.com/cat/applications/lucid/couchdb/|Lucid 10.04]] || CouchDB 1.0.1 || Build from Source || + || All older releases || Not Supported, Embarrassingly Old || Cry From Shame || + + == Installing using an existing package == + {{{ - sudo apt-get install couchdb + sudo apt-get install couchdb -y }}} + === Troubleshooting === + If the aptitude/apt-get installation gives an error message then couchdb might not have access to its pid file. Fix: @@ -25, +38 @@ sudo dpkg --configure couchdb }}} + For older releases of Ubuntu we strongly recommend to build from source. + + == Installing from Source on Precise and Quantal == + + Download CouchDB from an [[http://www.apache.org/dyn/closer.cgi\?path=couchdb/releases/1.2.0/apache-couchdb-1.2.0.tar.gz|apache mirror]]. + + {{{ + ### make sure you have a couchdb user for the daemon, and couchb group also + ## get developer tools dependencies + sudo apt-get install -y g++ + sudo apt-get install -y erlang-dev erlang-manpages erlang-base-hipe erlang-eunit erlang-nox erlang-xmerl erlang-inets + ### other packages that are not required but may be useful + # - require GUI packages / X + # sudo apt-get install -y erlang-observer erlang-appmon erlang-debugger erlang-et + # - useful erlang tools to develop with + # sudo apt-get install -y erlang-dialyzer erlang-percept erlang-typer erlang-edoc erlang-os-mon erlang-runtime-tools erlang-inviso erlang-tools + + ### couchdb developer dependencies + sudo apt-get install -y libmozjs185-dev libicu-dev libcurl4-gnutls-dev libtool + ### unpack source + cd /tmp && tar xvzf apache-couchdb-1.2.0.tar.gz + cd apache-couchdb-* + ./configure && make + ### install + sudo make install + + ### remove leftovers from ubuntu packages + sudo rm /etc/logrotate.d/couchdb /etc/init.d/couchdb + + ### install logrotate and initd scripts + sudo ln -s /usr/local/etc/logrotate.d/couchdb /etc/logrotate.d/couchdb + sudo ln -s /usr/local/etc/init.d/couchdb /etc/init.d + sudo update-rc.d couchdb defaults + }}} + == Installing From Source == === Easiest: using build-couchdb === - There is a project called [[https://github.com/iriscouch/build-couchdb|build-couchdb]] that automates and simplifies the building of CouchDB and it's dependencies. If you want to build the newest version of Couch with the least amount of pain this is probably your best bet. See the [[https://github.com/iriscouch/build-couchdb|project Readme]] for instructions. + There is a project called [[https://github.com/iriscouch/build-couchdb|build-couchdb]] that automates and simplifies the building of CouchDB and its dependencies. If you want to build the newest version of Couch with the least amount of pain this is probably your best bet. See the [[https://github.com/iriscouch/build-couchdb|project Readme]] for instructions. === Advanced: manual building === @@ -317, +365 @@ Last but not least — if no logs are needed, just turn them off completely. - These logging tips are based on the recommendations found on Till Klampäckel's Blog article ''[[http://till.klampaeckel.de/blog/archives/95-Operating-CouchDB.html|Operating CouchDB]]''. + These logging tips are based on the recommendations found on Till Klampäckel's Blog article ''[[http://till.klampaeckel.de/blog/archives/95-Operating-CouchDB.html|Operating CouchDB]]''. == Note on installing on Ubuntu Desktop flavors == If you're ''not'' running Ubuntu server, but rather running some variant of Ubuntu desktop, I'd strongly recommend compiling from source and keeping the default prefix of `/usr/local`. Ubuntu comes standard with ''couchdb-bin'', and uses ''desktop-couch'' with tools like Ubuntu One, gwibber, and evolution. But, Lucid Lynx ships with version 0.10.0. This is a long-term support item, but that doesn't mean Canonical will be releasing 0.11 anytime soon.
