From b2e722cf2be80f856ffcd1ae740578fd1d4ba233 Mon Sep 17 00:00:00 2001
From: Markus Krogh <markus@nordu.net>
Date: Wed, 13 Jun 2018 14:07:21 +0200
Subject: Adding go dev tip

---
 README.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

(limited to 'README.md')

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
+```
-- 
cgit v1.1