fix(compose): honor BUZZ_MINIO_HOST_PORT / BUZZ_ADMINER_HOST_PORT for local port overrides

Extends the PGPORT / BUZZ_REDIS_HOST_PORT pattern (block#2511) to the last two
hardcoded host publishes so a local MinIO/S3 or Adminer on :9000/:9001/:8082
no longer blocks `docker compose up`.

- docker-compose.yml: parameterize minio (9000/9001) and adminer (8082) host
  ports via ${VAR:-default}; container ports unchanged.
- .env.example: document the new knobs and the BUZZ_S3_ENDPOINT pairing.
- dev-setup.sh: honor BUZZ_ADMINER_HOST_PORT in the readiness banner.

Refs block#2479, block#2511

Author: MiPnamic

.env.example

@@ -10,16 +10,20 @@
 #   Postgres    → localhost:5432   (override with PGPORT + DATABASE_URL together)
 #   Redis       → localhost:6379   (override with BUZZ_REDIS_HOST_PORT + REDIS_URL)
 #   Typesense   → localhost:8108
-#   Adminer     → localhost:8082  (DB browser UI)
+#   Adminer     → localhost:8082   (override with BUZZ_ADMINER_HOST_PORT)
+#   MinIO/S3    → localhost:9000   (override with BUZZ_MINIO_HOST_PORT + BUZZ_S3_ENDPOINT)
+#   MinIO cons. → localhost:9001   (override with BUZZ_MINIO_CONSOLE_HOST_PORT)
 #
-# If Homebrew (or another) Postgres/Redis already owns :5432/:6379, pick free
-# host ports and keep the connection URLs in sync, for example:
+# If Homebrew (or another) service already owns one of these host ports, pick a
+# free host port and keep the paired connection URL in sync, for example:
 #   PGPORT=55432
 #   DATABASE_URL=postgres://buzz:buzz_dev@localhost:55432/buzz
 #   BUZZ_REDIS_HOST_PORT=56379
 #   REDIS_URL=redis://localhost:56379
-#
-# Note: If port 8082 conflicts, change the adminer port in docker-compose.yml
+#   BUZZ_MINIO_HOST_PORT=59000
+#   BUZZ_S3_ENDPOINT=http://localhost:59000
+#   BUZZ_MINIO_CONSOLE_HOST_PORT=59001
+#   BUZZ_ADMINER_HOST_PORT=58082
 # =============================================================================
 
 # -----------------------------------------------------------------------------
@@ -85,6 +89,16 @@ RELAY_URL=ws://localhost:3000
 # BUZZ_GIT_PACK_CACHE_MAX_BYTES=5368709120
 # BUZZ_GIT_PACK_CACHE_MAX_CONCURRENT_POPULATIONS=2
 
+# -----------------------------------------------------------------------------
+# MinIO / S3 media storage
+# -----------------------------------------------------------------------------
+# Host ports published by docker-compose (container still listens on 9000/9001).
+# If a local MinIO/S3 owns :9000, pick a free host port and keep BUZZ_S3_ENDPOINT
+# in sync — the relay defaults to http://localhost:9000.
+# BUZZ_MINIO_HOST_PORT=9000
+# BUZZ_MINIO_CONSOLE_HOST_PORT=9001
+# BUZZ_S3_ENDPOINT=http://localhost:9000
+
 # -----------------------------------------------------------------------------
 # Media Upload Admission
 # -----------------------------------------------------------------------------

docker-compose.yml

@@ -58,7 +58,8 @@ services:
     image: adminer:latest
     container_name: buzz-adminer
     ports:
-      - "8082:8080"
+      # Host port follows BUZZ_ADMINER_HOST_PORT so a local :8082 can be freed (#2479).
+      - "${BUZZ_ADMINER_HOST_PORT:-8082}:8080"
     networks:
       - buzz-net
     depends_on:
@@ -110,8 +111,10 @@ services:
       MINIO_ROOT_USER: buzz_dev
       MINIO_ROOT_PASSWORD: buzz_dev_secret
     ports:
-      - "9000:9000"
-      - "9001:9001"
+      # Host ports follow BUZZ_MINIO_HOST_PORT / BUZZ_MINIO_CONSOLE_HOST_PORT so a
+      # local MinIO/S3 can keep :9000/:9001. Keep BUZZ_S3_ENDPOINT in sync (#2479).
+      - "${BUZZ_MINIO_HOST_PORT:-9000}:9000"
+      - "${BUZZ_MINIO_CONSOLE_HOST_PORT:-9001}:9001"
     volumes:
       - minio-data:/data
     networks:

scripts/dev-setup.sh

@@ -189,7 +189,7 @@ echo -e "${GREEN}=======================================================${NC}"
 echo ""
 echo -e "  ${BLUE}Postgres${NC}    ${DATABASE_URL}"
 echo -e "  ${BLUE}Redis${NC}       ${REDIS_URL}"
-echo -e "  ${BLUE}Adminer${NC}     http://localhost:8082  (DB browser)"
+echo -e "  ${BLUE}Adminer${NC}     http://localhost:${BUZZ_ADMINER_HOST_PORT:-8082}  (DB browser)"
 echo -e "  ${BLUE}Keycloak${NC}    http://localhost:8180  (admin / admin — local OAuth testing)"
 echo ""
 echo -e "  ${YELLOW}Next steps:${NC}"