2. Installation — Apache CouchDB 2.0 Documentation

### Navigation

- API Reference
- Config Reference |
- next |
- previous |
- Apache CouchDB 2.0 Documentation »

# 2. Installation

- 2.1. Installation on Unix-like systems
  - 2.1.1. Dependencies
  - 2.1.2. Installing
  - 2.1.3. User Registration and Security
  - 2.1.4. First Run
  - 2.1.5. Running as a Daemon
- 2.2. Installation on Windows
  - 2.2.1. Installation from binaries
  - 2.2.2. Installation from sources
- 2.3. Installation on Mac OS X
  - 2.3.1. Installation using the Apache CouchDB native application
  - 2.3.2. Installation with Homebrew
- 2.4. Installation on FreeBSD
  - 2.4.1. Installation from ports
- 2.5. Troubleshooting an Installation
  - 2.5.1. First Install
  - 2.5.2. Quick Build
  - 2.5.3. Upgrading
  - 2.5.4. Runtime Errors

## 2.6. Single Node Setup

CouchDB 2.0 can be used in a single-node and cluster setup configuration. A single-node CouchDB 2.0 installation is what most users will be using. It is roughly equivalent to the CouchDB 1.x-series. Note that a single-node setup obviously doesn’t take any advantage of the new scaling and fault-tolerance features in CouchDB 2.0.

After installation and initial startup, visit Fauxton at `http://127.0.0.01:5984/_utils#setup`. You will be asked to set up CouchDB as a single-node instance or set up a cluster.

When you click “Single-Node-Setup”, you will get asked for an admin username and password. Choose them well and remember them. You can also bind CouchDB to a public port, so it is accessible within your LAN or the public, if you are doing this on a public VM.

When you run 2.0 as a single node, it doesn’t create system databases on startup. You have to do this manually:

    curl -X PUT http://127.0.0.1:5984/_users

    curl -X PUT http://127.0.0.1:5984/_replicator

    curl -X PUT http://127.0.0.1:5984/_global_changes

See the next section for the cluster setup instructions.

## 2.7. Cluster Setup

See the Cluster Reference for details.

### Navigation

- API Reference
- Config Reference |
- next |
- previous |
- Apache CouchDB 2.0 Documentation »