Installing CouchDB on Windows (Quick Guide)

Javascript , Apache CouchDB Add comments

Apache CouchDB

Seeing as everyone else out there except me (and a few others) uses a Mac, I thought I'd write this short post regarding installing CouchDB on Windows and how to access the Futon Administration console.

Apache CouchDB is a document-oriented database that can be queried and indexed in a MapReduce fashion using JavaScript. CouchDB also offers incremental replication with bi-directional conflict detection and resolution.

As promised, the quick and dirty way to install CouchDB on windows is as follows:

  1. Click here to visit the Wiki and download the installer.  At the time of writing the latest installer was v1.0.1
  2. When downloaded, run the installer as an "Administrator" and follow the on-screen instructions.
  3. To install couchDB as a Windows Service, leave the default selections as it's automatically configured to do so.
  4. Once the installation is complete, for the default installation options, the service "Apache couchDB" should be running under the local system account.
    1. If, after installation you are experiencing permissions issues, see here.
  5. Open a modern web browser, in otherwords Firefox (this is also the recommended browser to use).
  6. Navigate to: http://127.0.0.1:5984
    1. You should see the following text: {"couchdb":"Welcome","version":"1.0.1"}
  7. To access Futon (Administration console) Navigate to: http://127.0.0.1:5984/_utils
  8. That's It !!

Told you it was a quick guide ;-)

I will be exploring couchDB further in the near future and will post my experiences here for anyone else who is interested.

In particular, I'll be looking at:

 

Bookmark and Share

7 responses to “Installing CouchDB on Windows (Quick Guide)”

  1. Dave Cottlehuber Says:
    Hi Niall,

    great to see some more people using CouchDB on Windows! There's more tips & tricks over at http://wiki.apache.org/couchdb/Quirks_on_Windows

    cheers
    Dave
  2. Niall Says:
    Hi Dave,
    Thanks for the "heads-up" on that resource!

    Regards,
    Niall.
  3. felix mc Says:
    am I the only one who doesn't have an installer, but rather a really long install instructions text file? (using couchDB 1.1.0)
  4. Niall O'Doherty Says:
    Hi Felix,
    There is a section called "Windows Installer" that provides a link to a number of different installer applications.

    I think the link you would be after, and the most popular, would be this one:

    https://github.com/downloads/juranki/couchdb/setup-couchdb-1.1.0acff79d0-git.exe

    Hopefully that will get you started!

    Cheers,
    Niall.
  5. Dave Cottlehuber Says:
    Hi folks,

    You're better off with these which match up to the released versions of CouchDB:

    https://github.com/dch/couchdb/downloads/

    @juranki's links are from trunk at the time & not based off the official releases.

    https://github.com/downloads/dch/couchdb/setup-couchdb-1.1.0+COUCHDB-1152_otp_R14B03.exe

    and there will soon be a a 1.0.3 there as well.

    Cheers
    Dave
  6. Justin Gaylor Says:
    Hi all,

    Just a quick comment for anyone trying CouchDB 1.1.0 (currently a trunk version) on Windows 7. It kept failing when I tried with an error related to OpenSSL. Backing up to CouchDB 1.0.2 works though. Not sure the source of the error...

    Very helpful HowTo! Thank you, Niall.

    Cheers,
    Justin
  7. Niall O'Doherty Says:
    Thanks for the update Justin! Much appreciated.

Leave a Reply

Leave this field empty:

Powered by Mango Blog. Design and Icons by N.Design Studio