Docker Compose projects
Detect and open
Ports and overlaps
What Rig is not
If the repo has a Compose file, Rig can treat it as a first-class project type — start and observe the stack from the same window as Node or Laravel projects.
Compose often binds published ports that collide with a local npm dev server. If start fails, use{" "} port reclaim {" "} or adjust the Compose publish mapping.
Rig orchestrates and observes — it does not replace Docker Desktop, your Compose mental model, or production Kubernetes. Use Compose as you already do; Rig is the control surface.
- Add the folder that contains docker-compose.yml (or compose.yaml).
- Confirm Rig detected Compose in the project summary.
- Start from Rig; watch service logs in the unified pane.
docker compose.yml docker-compose stack services up down logs detect compose project
Related guides
This article is part of the Rig knowledge base at userig.app/docs. Rig is a local-first Mac app that runs, watches, and restarts development processes with unified logs, ports, and a scoped MCP hub for AI coding agents. Your source code stays on your Mac.