A control panel for local multi-project Docker setups. Regatta lives in the VS Code sidebar, discovers your docker-compose projects, shows their status and ports, and flags port conflicts between them – so juggling ~10 local projects stops being manual port-wrangling.

Regatta

Features

Project discovery – scans the folders you configure for docker-compose*.yml / compose*.yml and lists every project it finds.
Status at a glance – running / stopped per project, with a live summary of how many are running and how many are blocked.
Start / stop – one click per project, straight from the sidebar.
Stacks – group projects that belong together (e.g. an API and its frontend) into a collapsible folder and start or stop them as one.
Port intelligence – shows each project's host ports and detects conflicts:
- green – the port is served by this running project;
- red – the port is already taken (by another project, a Docker container, or an external process) → starting is blocked;
- amber – the port might be in use (a process owned by you) → start stays enabled with a warning.
Live updates – reflects container start / stop in real time via docker events, with no polling.
Logs – open a running project's live logs in a terminal.
Configurable folders – point Regatta at the folders that hold your projects, add and remove them from a built-in manager, and tune how deep it scans.

Requirements

VS Code ^1.90
Docker with the docker compose CLI available on your PATH

Getting started

Install Regatta from the VS Code Marketplace – search for it in the Extensions view (Cmd/Ctrl+Shift+X), or grab it from the Marketplace page.

Open the Regatta view from the Activity Bar. On first run the panel is empty – click Add folder (or run Regatta: Add Folder) and point it at the folder(s) that contain your projects.

Settings

regatta.roots – folders Regatta scans for docker-compose projects; when empty, it falls back to the open workspace folders. Default [].
regatta.scanDepth – how many folder levels deep to scan from each root; higher finds more deeply nested projects but scans slower. Default 3.

Commands

Regatta: Add Folder – pick folders to scan for projects.
Regatta: Manage Folders – view, add, and remove scan folders.
New stack – group two or more projects into a stack.

How it works

Conflicts are dynamic: a port only counts as taken when something is actually listening on it. With everything stopped there are no conflicts. Start a project and it occupies its ports; any stopped project that declares one of those ports becomes blocked, with the reason shown inline. Occupancy is detected machine-wide – a bind test (which matches how Docker itself binds), lsof for your own processes, and docker ps for container port maps – and attributed to a named holder wherever possible.