Difference between revisions of "Couchdb"

From ArchWiki
Jump to: navigation, search
m (Running)
(Added instructions for creating admin accounts)
Line 43: Line 43:
  
 
Futon can be accessed over ssl on port 6984 via https://localhost:6984/_utils/
 
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 [http://lizconlan.github.com/sandbox/securing-couchdb.html create a read-only database] for locking down databases and further security.
 +
 
 +
  [admins]
 +
  admin = magicalunicorns
  
 
== More Resources ==
 
== More Resources ==

Revision as of 20:47, 29 July 2011

Installation

Install the Couchdb package:

# pacman -S couchdb

Running

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

Configuring

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 server.key.org
 # openssl rsa -in server.key.org -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

 [daemons]
 httpsd = {couch_httpd, start_link, [https]}
 [ssl]
 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.

 [admins]
 admin = magicalunicorns

More Resources