ci: docker compose for easy access

docs/run-instructions.md

@@ -114,6 +114,25 @@ bun run dev
 - Web: `http://localhost:5173`
 - API: `http://localhost:3000`
 
+## Docker Compose Deployment
+
+Run the deployable stack with one command:
+
+```bash
+cp .env.example .env
+docker compose up -d
+```
+
+Default Docker endpoints:
+
+- Web: `http://localhost:3001`
+- API: `http://localhost:3000`
+
+The Compose stack starts PostgreSQL, applies the schema, and seeds the sample admin only if the users table is empty.
+
+Docker Compose reads the root `.env` file automatically. Edit it before startup if you need different ports, public URLs, credentials, or secrets.
+
+
 ## Current Behavior Notes
 
 ### List Ordering
@@ -157,4 +176,4 @@ bun x tsc --noEmit -p packages/api/tsconfig.json
 - Full workspace typecheck may still fail because of a pre-existing `apps/desktop` typing issue for `three`.
 - The verified implementation path is the web app + server app + database push + database seed.
 - DNS checking is limited to A record / IPv4.
-- This project is not a deployment platform and does not include SSH, Docker orchestration, or reverse proxy automation.
+- Docker Compose is available for running the app stack; the app itself does not include SSH, reverse proxy, or host orchestration automation.