| .. Licensed under the Apache License, Version 2.0 (the "License"); you may not |
| .. use this file except in compliance with the License. You may obtain a copy of |
| .. the License at |
| .. |
| .. http://www.apache.org/licenses/LICENSE-2.0 |
| .. |
| .. Unless required by applicable law or agreed to in writing, software |
| .. distributed under the License is distributed on an "AS IS" BASIS, WITHOUT |
| .. WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the |
| .. License for the specific language governing permissions and limitations under |
| .. the License. |
| |
| Configuration Reference |
| ======================= |
| |
| |
| 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 | |
| +----------------------------------+-------------------------------------------+ |
| |
| attachments Configuration Options |
| --------------------------------- |
| |
| +--------------------------------------+---------------------------------------+ |
| | Option | Description | |
| +======================================+=======================================+ |
| | compressible_types | compressible_types | |
| +--------------------------------------+---------------------------------------+ |
| | compression_level | compression_level | |
| +--------------------------------------+---------------------------------------+ |
| |
| 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 | |
| +--------------------------------------+---------------------------------------+ |
| |
| 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 | |
| +--------------------------------------+---------------------------------------+ |
| |
| httpd_db_handlers Configuration Options |
| --------------------------------------- |
| |
| +--------------------------------------+---------------------------------------+ |
| | Option | Description | |
| +======================================+=======================================+ |
| | _changes | _changes | |
| +--------------------------------------+---------------------------------------+ |
| | _compact | _compact | |
| +--------------------------------------+---------------------------------------+ |
| | _design | _design | |
| +--------------------------------------+---------------------------------------+ |
| | _temp_view | _temp_view | |
| +--------------------------------------+---------------------------------------+ |
| | _view_cleanup | _view_cleanup | |
| +--------------------------------------+---------------------------------------+ |
| |
| .. _config-couch_httpd_auth: |
| |
| 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 | |
| +--------------------------------------+---------------------------------------+ |
| | users_db_public | Allow all users to view user documents| |
| +--------------------------------------+---------------------------------------+ |
| | public_fields | World-viewable user document fields | |
| +--------------------------------------+---------------------------------------+ |
| |
| .. note:: |
| Using the `public_fields` whitelist for user document properties requires |
| setting the `users_db_public` option to `true` (the latter option has no |
| other purpose). |
| |
| 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 | |
| +--------------------------------------+---------------------------------------+ |
| |
| httpd_design_handlers Configuration Options |
| ------------------------------------------- |
| |
| +--------------------------------------+---------------------------------------+ |
| | Option | Description | |
| +======================================+=======================================+ |
| | _info | _info | |
| +--------------------------------------+---------------------------------------+ |
| | _list | _list | |
| +--------------------------------------+---------------------------------------+ |
| | _rewrite | _rewrite | |
| +--------------------------------------+---------------------------------------+ |
| | _show | _show | |
| +--------------------------------------+---------------------------------------+ |
| | _update | _update | |
| +--------------------------------------+---------------------------------------+ |
| | _view | _view | |
| +--------------------------------------+---------------------------------------+ |
| |
| 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 | |
| +--------------------------------------+---------------------------------------+ |
| |
| log Configuration Options |
| ------------------------- |
| |
| +--------------------------------------+---------------------------------------+ |
| | Option | Description | |
| +======================================+=======================================+ |
| | file | file | |
| +--------------------------------------+---------------------------------------+ |
| | include_sasl | include_sasl | |
| +--------------------------------------+---------------------------------------+ |
| | level | level | |
| +--------------------------------------+---------------------------------------+ |
| |
| query_servers Configuration Options |
| ----------------------------------- |
| |
| +--------------------------------------+---------------------------------------+ |
| | Option | Description | |
| +======================================+=======================================+ |
| | javascript | javascript | |
| +--------------------------------------+---------------------------------------+ |
| |
| query_server_config Configuration Options |
| ----------------------------------------- |
| |
| +--------------------------------------+---------------------------------------+ |
| | Option | Description | |
| +======================================+=======================================+ |
| | reduce_limit | reduce_limit | |
| +--------------------------------------+---------------------------------------+ |
| |
| replicator Configuration Options |
| -------------------------------- |
| |
| +--------------------------------------+---------------------------------------+ |
| | Option | Description | |
| +======================================+=======================================+ |
| | max_http_pipeline_size | max_http_pipeline_size | |
| +--------------------------------------+---------------------------------------+ |
| | max_http_sessions | max_http_sessions | |
| +--------------------------------------+---------------------------------------+ |
| |
| stats Configuration Options |
| --------------------------- |
| |
| +--------------------------------------+---------------------------------------+ |
| | Option | Description | |
| +======================================+=======================================+ |
| | rate | rate | |
| +--------------------------------------+---------------------------------------+ |
| | samples | samples | |
| +--------------------------------------+---------------------------------------+ |
| |
| uuids Configuration Options |
| --------------------------- |
| |
| +--------------------------------------+---------------------------------------+ |
| | Option | Description | |
| +======================================+=======================================+ |
| | algorithm | algorithm | |
| +--------------------------------------+---------------------------------------+ |
| |
| |
| 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. |
| |
| 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]` |