Jelajahi Sumber

Added installation instructions to README. Fixes #1

Daniel Moore 11 tahun lalu
induk
melakukan
a2e065cccd
1 mengubah file dengan 46 tambahan dan 2 penghapusan
  1. 46 2
      README.md

+ 46 - 2
README.md

@@ -1,2 +1,46 @@
-couchdb-ldap-auth
-=================
+# LDAP Authentication Handler for CouchDB
+
+## Features
+- Basic authentication handler
+- Session handler
+	- works with CouchDB built-in `cookie_authentication_handler`
+- Supports users and recursive-group association
+
+## Installation
+
+First, check out the source and `cd` into it.
+
+### Prerequisites
+- Erlang
+- Rebar
+
+### Build from Source
+
+```
+rebar clean compile
+```
+
+### Run Tests
+
+```
+rebar test
+```
+
+### Install binaries and config
+
+```
+# Create module folder
+mkdir /usr/local/lib/couchdb/erlang/lib/ldap-auth
+# Copy binaries
+cp -R ebin /usr/local/lib/couchdb/erlang/lib/ldap-auth/
+
+# Copy/overwrite the default config
+cp -f priv/default.d/* /usr/local/etc/couchdb/default.d/
+
+# Copy (but don't overwrite!) the custom config
+cp -n priv/local.d/* /usr/local/etc/couchdb/local.d/
+```
+
+## Configuration
+
+See [ldap_auth.ini] (priv/local.d/ldap_auth.ini) for details.