Team-City/TROUBLESHOOTING.md

Troubleshooting

Port 55432 Already Allocated (E2E Builds)

Symptom:
A build step like "Postgres Up" fails with:

Bind for 0.0.0.0:55432 failed: port is already allocated

Cause:
A Postgres container from a previous build was not cleaned up properly (e.g. build failed before reaching its teardown step). Since all E2E builds use the same hardcoded host port 55432, the stale container blocks any new build from starting.

Diagnosis:

# Find what's holding the port
docker ps --filter "publish=55432" --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

Fix:

# Remove the stale container (replace the name with the one from the command above)
docker rm -f <container-name>

Then re-run the failed build.

Prevention:
Ensure every build configuration runs docker compose down -v in a cleanup/always-run step so containers are torn down even when earlier steps fail.