I recently downloaded Apache CouchDB 2.1 installer for macOS from the official website. I already had CouchDB 1.7 installed via Homebrew Cask.

After installing CouchDB 2.1, I started observing some problems, like Local CouchDB on Mac Opens New Browser Tab Every 5 Seconds.

Other issues include inconsistent environment variables and ports in use. It appears that the macOS is unsure about the version of CouchDB installed and both the versions are running concurrently.

I figured, that a probable reason could be that CouchDB 1.7 was installed via Homebrew Cask, while Apache CouchDB was installed from the downloaded installer as it is not yet available via Homebrew Cask. They have your database migration covered, but not an 1.x-to-2.x upgrade path for the application itself on macOS.

I uninstalled Apache CouchDB 2.1 and killed the daemon that it left running. CouchDB 1.7 works fine after that.

How do I perform an upgrade in this scenario?

  • Please clarify how you installed couchdb 1.7.1! From the original question I derived that it was homebrew install couchdb! Glorfindel and Nimesh have a different opinion though: they think it was homebrew cask ... CouchDB 1.7.x! – klanomath Apr 4 '18 at 15:17
  • I believe it was just plain Homebrew. Is cask like pip? – charles ross Apr 5 '18 at 17:07
  • homebrew install couchdb will install unix execs to /usr/local/*. homebrew cask install apache-couchdbwill install an app to /Applications/ – klanomath Apr 5 '18 at 17:10

As of now, Apache CouchDB 2.1 is available via Homebrew Cask.


brew cask info apache-couchdb

lists the following output:

apache-couchdb: 2.1.1
Not installed
From: https://github.com/caskroom/homebrew-cask/blob/master/Casks/apache-couchdb.rb
==> Name
Apache CouchDB
==> Artifacts
Apache CouchDB.app (App)

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .