Configuration

CHT CouchDB configuration

CHT specific changes to default CouchDB configurations

Due to CHT particularities, several changes have been made to default CouchDB configuration. These changes are designed to improve performance, reliability, and to better support the CHT workflows. The configuration is bundled with the CouchDB Docker image and can be found in the CHT repository.

For more information about CouchDB configuration options, see the CouchDB documentation.

Note: Some CHT configuration values are the same as the default CouchDB values. This is the intention and ensures when changes occur in CouchDB versions over time, the CHT still has the value it needs.

Configuration Field Explanations

[Section] Field = value	Description	Default value
`[fabric]` `request_timeout = 31536000`	Sets internal Cluster CouchDB request timeout in seconds.	60000. Not documented.
`[query_server_config]` `os_process_limit = 1000`	Sets the maximum number of OS processes that can be spawned by CouchDB.	100
`[couchdb]` `os_process_timeout = 60000`	Sets the maximum time in milliseconds that an OS process can run before being terminated.	5000
`[couchdb]` `max_dbs_open = 5000`	Sets the maximum number of databases that can be open simultaneously.	100
`[couchdb]` `attachment_stream_buffer_size = 16384`	Sets the size of the buffer used to stream attachments.	4096
`[couchdb]` `max_document_size = 4294967296`	Limit maximum document body size.	8000000
`[couchdb]` `changes_doc_ids_optimization_threshold = 40000`	Change requests with docs ids optimization treshold.	100. Not documented.
`[chttpd]` `port = 5984`	Sets the port on which CouchDB listens for HTTP requests.	5984
`[chttpd]` `bind_address = 0.0.0.0`	HTTP port IP address binding.	127.0.0.1
`[chttpd]` `require_valid_user = true`	Require authentication for all requests .	false
`[httpd]` `secure_rewrites = false`	This option allow to isolate databases via subdomains.	true
`[httpd]` `max_http_request_size = 4294967296`	Limit the maximum size of the HTTP request body.	4294967296
`[httpd]` `WWW-Authenticate = Basic realm="Medic Mobile Web Services"`	Avoid base auth popups in the browser.
`[couch_httpd_auth]` `timeout = 31536000`	Number of seconds since the last request before sessions will be expired.	600
`[couch_httpd_auth]` `allow_persistent_cookies = true`	CouchDB will set the Max-Age and Expires attributes on the cookie.	true
`[chttpd_auth_lockout]` `mode = warn`	Sets the authentication lockout mode.	enforce
`[ssl]` `verify_ssl_certificates = false`	Set to true to validate peer certificates.	false
`[ssl]` `ssl_certificate_max_depth = 4`	Maximum peer certificate depth.	1
`[cluster]` `q = 12`	Sets the default number of shards for newly created databases.	2
`[cluster]` `n = 1`	Sets the number of replicas of each document in a cluster.	3
`[attachments]` `compressible_types = text/*, application/javascript, application/json, application/xml`	Sets which attachment MIME types will be compressed.	text/*, application/javascript, application/json, application/xml
`[attachments]` `compression_level = 8`	Defines zlib compression level for the attachments.	8
`[nouveau]` `enable = true`	Enables Nouveau.	false
`[nouveau]` `url = http://nouveau:5987`	Nouveau Server address.	Empty

Last updated on January 14, 2026

Did this documentation help you ?

Auditing Conflicts