From dacd65602cb7d770c58985596206a82476ef49e9 Mon Sep 17 00:00:00 2001
From: William Mantly <wmantly@gmail.com>
Date: Sat, 11 Jul 2026 21:02:03 -0400
Subject: [PATCH] README: add a Logs section for the Docker stack

Both services (sso-manager, proxy) run under Compose; document how to get
logs via docker compose logs, the proxy's nginx access/error logs (which go
to /var/log/nginx on the proxy-logs volume, not docker logs), and a direct
ldapsearch health check for the SSO.

Co-Authored-By: Claude <noreply@anthropic.com>
---
 README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/README.md b/README.md
index 6d77848..5684a7e 100644
--- a/README.md
+++ b/README.md
@@ -169,6 +169,54 @@ Optional: `BOOTSTRAP_ADMIN_EMAIL`, `LDAP_SERVICE_PASS` (auto-generated if blank)
 
 ---
 
+## Logs
+
+The stack runs under Docker Compose with two services — `sso-manager` and
+`proxy`. Both the Node app and, for the SSO, OpenLDAP write to the container's
+stdout/stderr, so `docker compose logs` is the primary view.
+
+```bash
+# Follow both services live
+docker compose logs -f
+
+# One service
+docker compose logs -f sso-manager
+docker compose logs -f proxy
+
+# Last 200 lines and keep following
+docker compose logs --tail=200 -f proxy
+
+# Only the last 10 minutes
+docker compose logs --since=10m sso-manager
+```
+
+The plain container names work too (`docker logs -f sso-manager`,
+`docker logs -f proxy`) — handy if you started the stack without Compose.
+
+### Proxy nginx access/error logs
+
+OpenResty writes its access/error logs to files inside the container
+(`/var/log/nginx`, on the `proxy-logs` volume), so they do **not** appear in
+`docker logs proxy`. Tail them directly:
+
+```bash
+docker compose exec proxy tail -f /var/log/nginx/access.log
+docker compose exec proxy tail -f /var/log/nginx/error.log
+```
+
+### SSO / LDAP logs
+
+slapd runs with `-d 0` and logs to stderr, so LDAP output is already in
+`docker compose logs sso-manager`. For a targeted health check, exec into the
+SSO and query the directory directly:
+
+```bash
+docker compose exec sso-manager ldapsearch -x -H ldap://localhost:389 \
+  -D "cn=admin,${LDAP_BASE_DN}" -W -b "${LDAP_BASE_DN}"
+```
+
+---
+
 ## Backups
 
 The directory lives in the `ldap-data` Docker volume. Back it up with `slapcat`