From ArchWiki
Revision as of 20:47, 29 July 2011 by Action owl (talk | contribs) (Added instructions for creating admin accounts)
Jump to: navigation, search


Install the Couchdb package:

# pacman -S couchdb


Start Couch

# rc.d start couchdb

To launch on startup add it to your daemons array in /etc/rc.conf

DAEMONS=(syslog-ng network netfs crond sshd httpd couchdb)

Using Futon

You can now access the Futon admin interface by going to http://localhost:5984/_utils


Change the default port, bind address, log-level and other useful nuggets in /etc/couchdb/local.ini

Note: Do not modify /etc/couchdb/default.ini as it gets overwritten whenever couchdb is updated. Also be sure to restart couchdb after changes to this file.

If you'd like to use ssl with a self-signed certificate you can create one like this:

 # cd /etc/couchdb
 # openssl genrsa -des3 -out server.key 1024
 # openssl req -new -key server.key -out server.csr
 # cp server.key
 # openssl rsa -in -out server.key
 # openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt

Then uncomment httpsd and update the path in the [ssl] section

 httpsd = {couch_httpd, start_link, [https]}
 cert_file = /etc/couchdb/server.crt
 key_file = /etc/couchdb/server.key

Futon can be accessed over ssl on port 6984 via https://localhost:6984/_utils/

Admin users can be created in your local.ini file. Add the username and password in plaintext, next time couch is restarted it will hash the password. See create a read-only database for locking down databases and further security.

 admin = magicalunicorns

More Resources