commit | 772786e79900f8085c595f8a579ae85d1fa05dad | [log] [tgz] |
---|---|---|
author | Bob Ippolito <bob@redivi.com> | Mon Oct 13 15:16:43 2014 -0700 |
committer | Bob Ippolito <bob@redivi.com> | Mon Oct 13 15:16:43 2014 -0700 |
tree | 9b683302143600cc8359dc5a013c71070518a7be | |
parent | 222a83f4e8a55517f991a98826b7ef02eae96355 [diff] | |
parent | de52d3d19a26898e4611486374b0751f2928ea0f [diff] |
Merge pull request #6 from redgeoff/install include installation instructions
couchperuser is a CouchDB daemon that ensures that a private per-user database exists for each document in _users. These databases are writable only by the corresponding user.
Currently this is very much purpose-built for CodeCosmos. Databases are in the form:
userdb-{hex encoded username}
For example, the user bob
will have a database named userdb-626f62
.
The reason for hex encoding is that CouchDB usernames have no restrictions, but CouchDB databases have restrictions. Hex encoding the UTF-8 representation of the username is a transformation that's easy to correctly implement in just about any language, especially JavaScript and Erlang. Other encodings would be possible, but would require additional client and server-side code to support that encoding. This is the simplest scheme that is obviously correct.
Install any dependencies. couchperuser
requires rebar
, e.g.
$ brew install rebar
Ensure the plugins
directory exists, e.g.
$ mkdir /usr/local/Cellar/couchdb/1.6.0_1/lib/couchdb/plugins
Clone (download) the repo:
$ git clone https://github.com/etrepum/couchperuser.git
Move the plugin files:
$ mv couchperuser /usr/local/Cellar/couchdb/1.6.0_1/lib/couchdb/plugins
Build the plugin files:
$ cd /usr/local/Cellar/couchdb/1.6.0_1/lib/couchdb/plugins $ make
Restart couchdb