10. Configuration Reference

10.1. Configuration Groups

Section Description
attachments Attachment options
couchdb CouchDB specific options
couch_httpd_auth HTTPD Authentication options
daemons Daemons and background processes
httpd HTTPD Server options
httpd_db_handlers Database Operation handlers
httpd_design_handlers Handlers for design document operations
httpd_global_handlers Handlers for global operations
log Logging options
query_servers Query Server options
query_server_config Query server options
replicator Replicator Options
ssl SSL (Secure Sockets Layer) Options
stats Statistics options
uuids UUID generation options
cors Cross Origin Resource Sharing settings

10.2. attachments Configuration Options

Option Description
compressible_types compressible_types
compression_level compression_level

10.3. couchdb Configuration Options

Option Description
database_dir database_dir
delayed_commits delayed_commits
max_attachment_chunk_size max_attachment_chunk_size
max_dbs_open max_dbs_open
max_document_size max_document_size
os_process_timeout os_process_timeout
uri_file uri_file
util_driver_dir util_driver_dir
view_index_dir view_index_dir

10.4. daemons Configuration Options

Option Description
auth_cache auth_cache
db_update_notifier db_update_notifier
external_manager external_manager
httpd httpd
httpsd Enabled HTTPS service
query_servers query_servers
stats_aggregator stats_aggregator
stats_collector stats_collector
uuids uuids
view_manager view_manager

10.5. httpd_db_handlers Configuration Options

Option Description
_changes _changes
_compact _compact
_design _design
_temp_view _temp_view
_view_cleanup _view_cleanup

10.6. couch_httpd_auth Configuration Options

Option Description
auth_cache_size auth_cache_size
authentication_db authentication_db
authentication_redirect authentication_redirect
require_valid_user require_valid_user
timeout timeout
iterations Password key derivation iterations

10.7. httpd Configuration Options

Option Description
allow_jsonp allow_jsonp
authentication_handlers authentication_handlers
bind_address bind_address
default_handler default_handler
max_connections max_connections
nodelay Enable TCP_NODELAY
port port
secure_rewrites secure_rewrites
vhost_global_handlers vhost_global_handlers
enable_cors enables CORS functionality when true

10.8. httpd_design_handlers Configuration Options

Option Description
_info _info
_list _list
_rewrite _rewrite
_show _show
_update _update
_view _view

10.9. httpd_global_handlers Configuration Options

Option Description
/ /
_active_tasks _active_tasks
_all_dbs _all_dbs
_config _config
_log _log
_oauth _oauth
_replicate _replicate
_restart _restart
_session _session
_stats _stats
_utils _utils
_uuids _uuids
favicon.ico favicon.ico

10.10. log Configuration Options

Option Description
file file
include_sasl include_sasl
level level

10.11. query_servers Configuration Options

Option Description
javascript javascript

10.12. query_server_config Configuration Options

Option Description
reduce_limit reduce_limit

10.13. replicator Configuration Options

Option Description
max_http_pipeline_size max_http_pipeline_size
max_http_sessions max_http_sessions

10.14. stats Configuration Options

Option Description
rate rate
samples samples

10.15. uuids Configuration Options

Option Description
algorithm algorithm

10.16. cors Configuration Options

Option Description
origins List of origins, separated by a comma (protocol, host, optional port)
methods accepted HTTP methods
credentials true sends additional header Access-Control-Allow-Credentials=true

Note that credentials=true and origins=* are mutually exclusive.

10.17. cors vhost Configuration

The same configuration options for cors overall may be applied to an individual vhost, within a specific section header, for example.com the appropriate section would be: [cors:http://example.com]