Turn document 2026-05-15 Issues: islandflow-c87, islandflow-2db

Warn about duplicate VPS compose stacks

Investigated the live VPS, confirmed that a second compose project from the repo-root local-infra stack is still running there, attempted cleanup, and added deploy/docs guardrails so this state is easier to spot and less likely to be recreated accidentally.

Summary

The live server currently has both islandflow-vps and an older islandflow compose project. The supported production traffic path uses islandflow-vps. I added a deploy-time warning and documentation updates so Docker remains the intended VPS path and the repo-root docker-compose.yml is clearly marked as local-only. I also attempted to remove the stale islandflow containers on the VPS, but Docker operations against them hung and timed out, so manual cleanup is tracked separately.

Changes Made

Context

The repo has two Docker entry points with different purposes. The root docker-compose.yml is a local development infra stack that publishes NATS, ClickHouse, and Redis on host ports. The supported VPS deployment lives under deployment/docker/ and uses an islandflow-vps compose project, internal service-name routing, and Nginx Proxy Manager on the shared Docker network. Running both on the VPS creates duplicate infra and can make host-level debugging confusing.

Important Implementation Details

[deploy] Warning: found an additional compose project named "islandflow" on the server.
[deploy] The live VPS should normally use only the deployment/docker stack (compose project "islandflow-vps").
[deploy] The repo-root docker-compose.yml is for local infra and can create duplicate exposed NATS, ClickHouse, and Redis services on the VPS.

Validation

ssh di 'docker ps --format "{{.Names}} {{.Label \"com.docker.compose.project\"}}" | grep "^islandflow-.* islandflow$" || true'
curl -I -fksS https://flow.deltaisland.io

Issues, Limitations, and Mitigations

Follow-up Work