logging and containerization setup

README.md

@@ -29,6 +29,48 @@ behavior while enabling modernization behind compatibility boundaries.
 - Prefer a single entrypoint script or container orchestration for local dev.
 - Add small smoke tests to validate service health and database connectivity.
 
+## Local Dev (C Services)
+
+If Couchbase is running on `localhost:8091` with bucket `hbs` (password `aci`),
+use the repo-local entrypoint to build and run the core servers:
+
+```sh
+./dev build
+./dev start
+./dev logs
+```
+
+Override targets via env vars:
+
+```sh
+HM_GAMESERVER_IP=127.0.0.1 HM_GAMESERVER_PORT=3724 ./dev start
+```
+
+Stop with:
+
+```sh
+./dev stop
+```
+
+For the full Ubuntu install flow (Couchbase + web + client), use
+`hearthmod/host_ctl_ubuntu.sh`.
+
+## Docker Dev
+
+Docker runs Couchbase plus the C servers. Start with:
+
+```sh
+./dev docker-build
+./dev docker-start
+./dev docker-logs
+```
+
+Stop with:
+
+```sh
+./dev docker-stop
+```
+
 ## Protocol Notes
 
 See `PROTOCOL-NOTES.md` for the current opcode decoder map and client-derived