fix(build): refactor docker install script

[motunrayokoyejo]

Added/expanded install-local.sh to provide a smoother first-time local setup flow.
Installer now validates prerequisites (git, curl, docker, docker compose, Docker daemon).
Added robust repo setup handling

---

Note

Low Risk
Changes are limited to the local install script and generated compose artifacts; no application runtime or auth paths are modified.

Overview
Local Docker install no longer hard-fails when default ports are busy. install-local.sh picks HTTP, Postgres, and PgBouncer host ports (env overrides CONVOY_HTTP_PORT, etc., with fallbacks from 8080/5434/6433), writes configs/local/docker-compose.install.generated.yml from the base compose file, and runs docker compose against that file only.

Convoy’s public URL stays aligned with the chosen HTTP port by patching the first "host" field in configs/local/convoy.json, and health checks / “open this URL” output use the same SELECTED_HOST_URL.

.gitignore now excludes the generated compose file and a legacy override path; the installer deletes the stale override file on upgrade.

^{Reviewed by Cursor Bugbot for commit ef8f00c. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit ef8f00c. Configure here.}

[cursor]

Unknown port eighty forced fallback

Medium Severity

When the default HTTP port cannot be probed (Python bind returns permission denied), resolve_host_port treats it as unavailable and picks a fallback such as 8080. Docker can still publish port 80 without that bind test, so installs on Linux without lsof often get the wrong public URL versus the previous installer.

 

^{Reviewed by Cursor Bugbot for commit ef8f00c. Configure here.}