summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/README.md b/README.md
index 9805772..bb54968 100644
--- a/README.md
+++ b/README.md
@@ -44,3 +44,23 @@ Primarily development variables:
- CSRF_INSECURE - allow csrf cookies to be sent over unencrypted http
- LDAP_SSL_SKIP_VERIFY - don't do ldap ssl verification
+
+## Development
+
+You can use docker-compose to get up and running. `docker-compose up --build` will recompile pwman, and start:
+
+- openldap server on port 6636
+- heimdal kerberos server on port 8888 and 7749
+- nginx listening on port 80
+- pwman
+
+For rapid testing that does not need to build docker images you can choose to just start the dependencies.
+
+```
+# edit dev/nginx/pwman-go.conf to not have upstream pwman:3000
+# In one window
+docker-compose up openldap krb5 nginx
+
+# In another (hacky since it is not under gopath)
+go run !(*_test).go -ldap-password secretpw -ldap-port 6636 -ldap-ssl-skip-verify -csrf-insecure -krb5-config dev/krb5.conf -changepw-script data/pwman/log-principal.pl
+```