@that1kid333/docker-proxy

Local Docker proxy for Vibe Coding IDE. This package bridges the browser-based IDE with Docker Desktop running on your machine.

What it does

Browser (Vibe Coding)  →  This Proxy (localhost:9876)  →  Docker Desktop

Since browsers cannot directly access Docker, this proxy runs locally and translates HTTP requests into Docker API calls.

Quick Start

npx @that1kid333/docker-proxy

You should see:

🔍 Checking Docker connection...
✓ Connected to Docker Desktop (v24.0.5)
  2 container(s) running on Docker Desktop

┌────────────────────────────────────────────┐
│       🐳 Vibe Docker Proxy                 │
├────────────────────────────────────────────┤
│  ✓ Proxy running on http://localhost:9876  │
│  ✓ Ready for connections from Vibe Coding  │
└────────────────────────────────────────────┘

Press Ctrl+C to stop the proxy

Prerequisites

• Docker Desktop must be installed and running
• Node.js 18+ for running the proxy

Usage

Basic

npx @that1kid333/docker-proxy

Custom Port

npx @that1kid333/docker-proxy --port 9877

Global Installation

npm install -g @that1kid333/docker-proxy
vibe-docker-proxy

API Endpoints

| Endpoint | Method | Description | |----------|--------|-------------| | /api/health | GET | Docker daemon status | | /api/containers | GET | List all containers | | /api/containers/:id | GET | Get container details | | /api/containers/:id/start | POST | Start a container | | /api/containers/:id/stop | POST | Stop a container | | /api/containers/:id | DELETE | Remove a container | | /api/containers/:id/logs | GET | Stream logs (SSE) | | /api/compose/up | POST | Start compose stack | | /api/compose/down | POST | Stop compose stack | | /api/compose/ps | GET | List compose services |

Security

• Binds to 127.0.0.1 only (no remote access)
• CORS restricted to localhost and *.lovable.app
• Validates compose files for dangerous mounts
• No privileged containers allowed

Troubleshooting

"Cannot connect to Docker"

Make sure Docker Desktop is running:

• Mac/Windows: Open Docker Desktop application
• Linux: Run sudo systemctl start docker

"Permission denied"

On Linux, add your user to the docker group:

sudo usermod -aG docker $USER
# Then log out and back in

Port already in use

Use a different port:

npx @that1kid333/docker-proxy --port 9877

License

MIT