xref: /5.5.2/couchdb/etc/couchdb/local.ini (revision a69a4ffe)
1; CouchDB Configuration Settings
2
3; Custom settings should be made in this file. They will override settings
4; in default.ini, but unlike changes made to default.ini, this file won't be
5; overwritten on server upgrade.
6
7[couchdb]
8;max_document_size = 4294967296 ; bytes
9
10[httpd]
11;port = 5984
12;bind_address = 127.0.0.1
13; Options for the MochiWeb HTTP server.
14;server_options = [{backlog, 128}, {acceptor_pool_size, 16}]
15; For more socket options, consult Erlang's module 'inet' man page.
16;socket_options = [{recbuf, 262144}, {sndbuf, 262144}, {nodelay, true}]
17
18; Uncomment next line to trigger basic-auth popup on unauthorized requests.
19;WWW-Authenticate = Basic realm="administrator"
20
21; Uncomment next line to set the configuration modification whitelist. Only
22; whitelisted values may be changed via the /_config URLs. To allow the admin
23; to change this value over HTTP, remember to include {httpd,config_whitelist}
24; itself. Excluding it from the list would require editing this file to update
25; the whitelist.
26;config_whitelist = [{httpd,config_whitelist}, {log,level}, {etc,etc}]
27
28[httpd_global_handlers]
29;_google = {couch_httpd_proxy, handle_proxy_req, <<"http://www.google.com">>}
30
31[log]
32;level = debug
33
34[os_daemons]
35; For any commands listed here, CouchDB will attempt to ensure that
36; the process remains alive while CouchDB runs as well as shut them
37; down when CouchDB exits.
38;foo = /path/to/command -with args
39
40[daemons]
41; enable SSL support by uncommenting the following line and supply the PEM's below.
42; the default ssl port CouchDB listens on is 6984
43; httpsd = {couch_httpd, start_link, [https]}
44
45[ssl]
46;cert_file = /full/path/to/server_cert.pem
47;key_file = /full/path/to/server_key.pem
48
49; To enable Virtual Hosts in CouchDB, add a vhost = path directive. All requests to
50; the Virual Host will be redirected to the path. In the example below all requests
51; to http://example.com/ are redirected to /database.
52; If you run CouchDB on a specific port, include the port number in the vhost:
53; example.com:5984 = /database
54
55[vhosts]
56;example.com = /database/
57
58[update_notification]
59;unique notifier name=/full/path/to/exe -with "cmd line arg"
60
61; To create an admin account uncomment the '[admins]' section below and add a
62; line in the format 'username = password'. When you next start CouchDB, it
63; will change the password to a hash (so that your passwords don't linger
64; around in plain-text files). You can add more admin accounts with more
65; 'username = password' lines. Don't forget to restart CouchDB after
66; changing this.
67[admins]
68;admin = mysecretpassword
69