Apache CouchDB™ 1.7.2 Documentation

• 1. Introduction
  • 1.1. Technical Overview
    • 1.1.1. Document Storage
    • 1.1.2. ACID Properties
    • 1.1.3. Compaction
    • 1.1.4. Views
    • 1.1.5. Security and Validation
    • 1.1.6. Distributed Updates and Replication
    • 1.1.7. Implementation
  • 1.2. Why CouchDB?
    • 1.2.1. Relax
    • 1.2.2. A Different Way to Model Your Data
    • 1.2.3. A Better Fit for Common Applications
    • 1.2.4. Building Blocks for Larger Systems
    • 1.2.5. CouchDB Replication
    • 1.2.6. Local Data Is King
    • 1.2.7. Wrapping Up
  • 1.3. Eventual Consistency
    • 1.3.1. Working with the Grain
    • 1.3.2. The CAP Theorem
    • 1.3.3. Local Consistency
    • 1.3.4. Validation
    • 1.3.5. Distributed Consistency
    • 1.3.6. Incremental Replication
    • 1.3.7. Case Study
    • 1.3.8. Wrapping Up
  • 1.4. Getting Started
    • 1.4.1. All Systems Are Go!
    • 1.4.2. Welcome to Futon
    • 1.4.3. Your First Database and Document
    • 1.4.4. Running a Query Using MapReduce
    • 1.4.5. Triggering Replication
    • 1.4.6. Wrapping Up
  • 1.5. The Core API
    • 1.5.1. Server
    • 1.5.2. Databases
    • 1.5.3. Documents
    • 1.5.4. Replication
    • 1.5.5. Wrapping Up
  • 1.6. Security
    • 1.6.1. Authentication
    • 1.6.2. Authentication Database
    • 1.6.3. Authorization
  • 1.7. Futon: Web GUI Administration Panel
    • 1.7.1. Managing Databases and Documents
    • 1.7.2. Configuring Replication
  • 1.8. cURL: Your Command Line Friend
• 2. Installation
  • 2.1. Installation on Unix-like systems
    • 2.1.1. Troubleshooting
    • 2.1.2. Dependencies
    • 2.1.3. Installing
    • 2.1.4. First Run
    • 2.1.5. Security Considerations
    • 2.1.6. 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.3.3. Installation from MacPorts
  • 2.4. Installation on FreeBSD
    • 2.4.1. Installation from ports
• 3. Configuring CouchDB
  • 3.1. Introduction Into Configuring
    • 3.1.1. Configuration files
    • 3.1.2. Parameter names and values
    • 3.1.3. Setting parameters via the configuration file
    • 3.1.4. Setting parameters via the HTTP API
  • 3.2. Base Configuration
    • 3.2.1. Base CouchDB Options
  • 3.3. CouchDB HTTP Server
    • 3.3.1. HTTP Server Options
    • 3.3.2. Secure Socket Level Options
    • 3.3.3. Cross-Origin Resource Sharing
    • 3.3.4. Virtual Hosts
  • 3.4. Authentication and Authorization
    • 3.4.1. Server Administrators
    • 3.4.2. Authentication Configuration
    • 3.4.3. HTTP OAuth Configuration
    • 3.4.4. OAuth Configuration
  • 3.5. Compaction Configuration
    • 3.5.1. Database Compaction Options
    • 3.5.2. Compaction Daemon Rules
    • 3.5.3. Configuration of Compaction Daemon
    • 3.5.4. Views Compaction Options
  • 3.6. Logging
    • 3.6.1. Logging options
    • 3.6.2. Per module logging
  • 3.7. Replicator
    • 3.7.1. Replicator Database Configuration
  • 3.8. Query Servers
    • 3.8.1. Query Servers Definition
    • 3.8.2. Query Servers Configuration
    • 3.8.3. Native Erlang Query Server
  • 3.9. External Processes
    • 3.9.1. OS Daemons
    • 3.9.2. OS Daemons settings
    • 3.9.3. Update notifications
  • 3.10. HTTP Resource Handlers
    • 3.10.1. Global HTTP Handlers
    • 3.10.2. Database HTTP Handlers
    • 3.10.3. Design Documents HTTP Handlers
  • 3.11. CouchDB Internal Services
    • 3.11.1. CouchDB Daemonized Mini Apps
  • 3.12. Miscellaneous Parameters
    • 3.12.1. Configuration of Attachment Storage
    • 3.12.2. Statistic Calculation
    • 3.12.3. UUIDs Configuration
    • 3.12.4. Vendor information
  • 3.13. Proxying Configuration
    • 3.13.1. CouchDB As Proxy
• 4. Replication
  • 4.1. Introduction Into Replications
    • 4.1.1. Triggering Replication
    • 4.1.2. Replication Procedure
    • 4.1.3. Master - Master replication
    • 4.1.4. Controlling which Documents to Replicate
    • 4.1.5. Migrating Data to Clients
  • 4.2. CouchDB Replication Protocol
    • 4.2.1. Preface
    • 4.2.2. Replication Protocol Algorithm
    • 4.2.3. Protocol Robustness
    • 4.2.4. Error Responses
    • 4.2.5. Optimisations
    • 4.2.6. API Reference
    • 4.2.7. Reference
  • 4.3. Replicator Database
    • 4.3.1. Basics
    • 4.3.2. Documents describing the same replication
    • 4.3.3. Canceling replications
    • 4.3.4. Server restart
    • 4.3.5. Changing the Replicator Database
    • 4.3.6. Replicating the replicator database
    • 4.3.7. Delegations
  • 4.4. Replication and conflict model
    • 4.4.1. CouchDB replication
    • 4.4.2. Conflict avoidance
    • 4.4.3. Conflicts in batches
    • 4.4.4. Revision tree
    • 4.4.5. Working with conflicting documents
    • 4.4.6. Multiple document API
    • 4.4.7. View map functions
    • 4.4.8. Merging and revision history
    • 4.4.9. Comparison with other replicating data stores
• 5. CouchDB Maintenance
  • 5.1. Compaction
    • 5.1.1. Database Compaction
    • 5.1.2. Views Compaction
    • 5.1.3. Automatic Compaction
  • 5.2. Performance
    • 5.2.1. Disk I/O
    • 5.2.2. System Resource Limits
    • 5.2.3. Network
    • 5.2.4. CouchDB
    • 5.2.5. Views
• 6. CouchApp
  • 6.1. Design Functions
    • 6.1.1. View functions
    • 6.1.2. Show functions
    • 6.1.3. List functions
    • 6.1.4. Update functions
    • 6.1.5. Filter functions
    • 6.1.6. Validate document update functions
  • 6.2. Guide to Views
    • 6.2.1. Introduction Into The Views
    • 6.2.2. Views Collation
    • 6.2.3. Joins With Views
    • 6.2.4. View Cookbook for SQL Jockeys
    • 6.2.5. Pagination Recipe
• 7. CouchDB Externals API
  • 7.1. The New Hotness
  • 7.2. How does it work? - HTTP Proxying
  • 7.3. How does it work? - OS Daemons
    • 7.3.1. Configuration API
    • 7.3.2. Logging API
    • 7.3.3. Dynamic Daemons
  • 7.4. Neat. But So What?
• 8. Query Server
  • 8.1. Query Server Protocol
    • 8.1.1. reset
    • 8.1.2. add_lib
    • 8.1.3. map_doc
    • 8.1.4. reduce
    • 8.1.5. rereduce
    • 8.1.6. ddoc
    • 8.1.7. Raising errors
    • 8.1.8. Logging
  • 8.2. JavaScript
    • 8.2.1. Design functions context
    • 8.2.2. CommonJS Modules
  • 8.3. Erlang
• 9. API Reference
  • 9.1. API Basics
    • 9.1.1. Request Format and Responses
    • 9.1.2. HTTP Headers
    • 9.1.3. JSON Basics
    • 9.1.4. HTTP Status Codes
  • 9.2. Server
    • 9.2.1. /
    • 9.2.2. /_active_tasks
    • 9.2.3. /_all_dbs
    • 9.2.4. /_db_updates
    • 9.2.5. /_log
    • 9.2.6. /_replicate
    • 9.2.7. /_restart
    • 9.2.8. /_stats
    • 9.2.9. /_utils
    • 9.2.10. /_uuids
    • 9.2.11. /favicon.ico
    • 9.2.12. Authentication
    • 9.2.13. Configuration
  • 9.3. Databases
    • 9.3.1. /db
    • 9.3.2. /db/_all_docs
    • 9.3.3. /db/_bulk_docs
    • 9.3.4. /db/_changes
    • 9.3.5. /db/_compact
    • 9.3.6. /db/_compact/design-doc
    • 9.3.7. /db/_ensure_full_commit
    • 9.3.8. /db/_view_cleanup
    • 9.3.9. /db/_security
    • 9.3.10. /db/_temp_view
    • 9.3.11. /db/_purge
    • 9.3.12. /db/_missing_revs
    • 9.3.13. /db/_revs_diff
    • 9.3.14. /db/_revs_limit
  • 9.4. Documents
    • 9.4.1. /db/doc
    • 9.4.2. /db/doc/attachment
  • 9.5. Design Documents
    • 9.5.1. /db/_design/design-doc
    • 9.5.2. /db/_design/design-doc/attachment
    • 9.5.3. /db/_design/design-doc/_info
    • 9.5.4. /db/_design/design-doc/_view/view-name
    • 9.5.5. /db/_design/design-doc/_show/show-name
    • 9.5.6. /db/_design/design-doc/_show/show-name/doc-id
    • 9.5.7. /db/_design/design-doc/_list/list-name/view-name
    • 9.5.8. /db/_design/design-doc/_list/list-name/other-ddoc/view-name
    • 9.5.9. /db/_design/design-doc/_update/update-name
    • 9.5.10. /db/_design/design-doc/_update/update-name/doc-id
    • 9.5.11. /db/_design/design-doc/_rewrite/path
  • 9.6. Local (non-replicating) Documents
    • 9.6.1. /db/_local/id
• 10. JSON Structure Reference
  • 10.1. All Database Documents
  • 10.2. Bulk Document Response
  • 10.3. Bulk Documents
  • 10.4. Changes information for a database
  • 10.5. CouchDB Document
  • 10.6. CouchDB Error Status
  • 10.7. CouchDB database information object
  • 10.8. Design Document
  • 10.9. Design Document Information
  • 10.10. Document with Attachments
  • 10.11. List of Active Tasks
  • 10.12. Replication Settings
  • 10.13. Replication Status
  • 10.14. Request object
  • 10.15. Response object
  • 10.16. Returned CouchDB Document with Detailed Revision Info
  • 10.17. Returned CouchDB Document with Revision Info
  • 10.18. Returned Document with Attachments
  • 10.19. Security Object
  • 10.20. User Context Object
  • 10.21. View Head Information
• 11. Experimental Features
  • 11.1. NodeJS Query Server
    • 11.1.1. Setup
    • 11.1.2. Differences from the SpiderMonkey Query Server
  • 11.2. Plugins
• 12. Contributing to this Documentation
• 13. Release History
  • 13.1. 1.7.x Branch
    • 13.1.1. Version 1.7.2
    • 13.1.2. Version 1.7.1
    • 13.1.3. Version 1.7.0
  • 13.2. 1.6.x Branch
    • 13.2.1. Deprecations
    • 13.2.2. Version 1.6.1
    • 13.2.3. Version 1.6.0
  • 13.3. 1.5.x Branch
    • 13.3.1. Version 1.5.1
    • 13.3.2. Version 1.5.0
  • 13.4. 1.4.x Branch
    • 13.4.1. Upgrade Notes
    • 13.4.2. Version 1.4.0
  • 13.5. 1.3.x Branch
    • 13.5.1. Upgrade Notes
    • 13.5.2. Version 1.3.1
    • 13.5.3. Version 1.3.0
  • 13.6. 1.2.x Branch
    • 13.6.1. Upgrade Notes
    • 13.6.2. Version 1.2.2
    • 13.6.3. Version 1.2.1
    • 13.6.4. Version 1.2.0
  • 13.7. 1.1.x Branch
    • 13.7.1. Upgrade Notes
    • 13.7.2. Version 1.1.2
    • 13.7.3. Version 1.1.1
    • 13.7.4. Version 1.1.0
  • 13.8. 1.0.x Branch
    • 13.8.1. Upgrade Notes
    • 13.8.2. Version 1.0.4
    • 13.8.3. Version 1.0.3
    • 13.8.4. Version 1.0.2
    • 13.8.5. Version 1.0.1
    • 13.8.6. Version 1.0.0
  • 13.9. 0.11.x Branch
    • 13.9.1. Upgrade Notes
    • 13.9.2. Version 0.11.2
    • 13.9.3. Version 0.11.1
    • 13.9.4. Version 0.11.0
  • 13.10. 0.10.x Branch
    • 13.10.1. Upgrade Notes
    • 13.10.2. Version 0.10.2
    • 13.10.3. Version 0.10.1
    • 13.10.4. Version 0.10.0
  • 13.11. 0.9.x Branch
    • 13.11.1. Upgrade Notes
    • 13.11.2. Version 0.9.2
    • 13.11.3. Version 0.9.1
    • 13.11.4. Version 0.9.0
  • 13.12. 0.8.x Branch
    • 13.12.1. Version 0.8.1-incubating
    • 13.12.2. Version 0.8.0-incubating
• 14. Security Issues Information
  • 14.1. CVE-2010-0009: Apache CouchDB Timing Attack Vulnerability
    • 14.1.1. Description
    • 14.1.2. Mitigation
    • 14.1.3. Example
    • 14.1.4. Credit
  • 14.2. CVE-2010-2234: Apache CouchDB Cross Site Request Forgery Attack
    • 14.2.1. Description
    • 14.2.2. Mitigation
    • 14.2.3. Example
    • 14.2.4. Credit
  • 14.3. CVE-2010-3854: Apache CouchDB Cross Site Scripting Issue
    • 14.3.1. Description
    • 14.3.2. Mitigation
    • 14.3.3. Example
    • 14.3.4. Credit
  • 14.4. CVE-2012-5641: Information disclosure via unescaped backslashes in URLs on Windows
    • 14.4.1. Description
    • 14.4.2. Mitigation
    • 14.4.3. Work-Around
    • 14.4.4. Acknowledgement
    • 14.4.5. References
  • 14.5. CVE-2012-5649: JSONP arbitrary code execution with Adobe Flash
    • 14.5.1. Description
    • 14.5.2. Mitigation
    • 14.5.3. Work-Around
  • 14.6. CVE-2012-5650: DOM based Cross-Site Scripting via Futon UI
    • 14.6.1. Description
    • 14.6.2. Mitigation
    • 14.6.3. Work-Around
    • 14.6.4. Acknowledgement
  • 14.7. CVE-2014-2668: DoS (CPU and memory consumption) via the count parameter to /_uuids
    • 14.7.1. Description
    • 14.7.2. Mitigation
    • 14.7.3. Work-Around
• 15. Reporting New Security Problems with Apache CouchDB
• 16. About CouchDB Documentation
  • 16.1. License