new changes

docs/ubuntu-dev-install.md

@@ -37,11 +37,13 @@ make down
 ```
 
 ## Services
-- API health: `http://localhost:8080/health`
-- PostgreSQL: `localhost:5432`
-- Redis: `localhost:6379`
-- NATS monitor: `http://localhost:8222`
-- MinIO console: `http://localhost:9001`
+Host ports are defined in `.env` (see `.env.example`). Defaults avoid common conflicts:
+
+- API health: `http://localhost:18080/health` (`API_PORT`)
+- PostgreSQL: `localhost:15432` (`POSTGRES_PORT`)
+- Redis: `localhost:16379` (`REDIS_PORT`)
+- NATS monitor: `http://localhost:18222` (`NATS_MONITOR_PORT`)
+- MinIO console: `http://localhost:19001` (`MINIO_CONSOLE_PORT`)
 
 ## Troubleshooting
 
@@ -61,6 +63,18 @@ or log out and SSH in again, then:
 bash scripts/docker-compose.sh up -d --build
 ```
 
+### `failed to bind host port ... address already in use`
+
+Another service on the host is using the same published port. Run:
+
+```bash
+bash scripts/ensure-env-ports.sh
+bash scripts/docker-compose.sh down
+bash scripts/docker-compose.sh up -d --build
+```
+
+Or edit `.env` manually (raise `REDIS_PORT`, `POSTGRES_PORT`, etc.).
+
 ## Notes
 - This is a development scaffold for the architecture implementation.
 - `panel-api` currently serves a minimal runtime entrypoint for health and bootstrap validation.