Introduction to Private Connect

# On the machine with the DB
connect expose localhost:5432 --name my-db

# From anywhere else
connect reach my-db
# → localhost:5432 now points at my-db. Same connection string, works everywhere.

┌─────────────────┐         ┌───────┐         ┌─────────────────┐
│   Your Server   │────────▶│  Hub  │◀────────│   Your Laptop   │
│                 │         └───────┘         │                 │
│ connect :5432   │                           │ connect prod-db │
└─────────────────┘                           └─────────────────┘

# On your laptop with the database
connect expose localhost:5432 --name my-db

# From Cursor (via MCP integration)
# AI can now: "What tables are in my-db?" or "Get connection string for my-db"

# New teammate's first day
connect clone sarah
# → ✓ Cloned 4 service(s) from sarah
# → Ready to code.

# .github/workflows/deploy.yml
steps:
  - name: Connect to private infra
    run: |
      curl -fsSL https://privateconnect.co/install.sh | bash
      connect up --api-key ${{ secrets.PRIVATECONNECT_KEY }}
      connect reach deploy-server
      
  - name: Deploy
    run: |
      rsync -avz ./dist/ localhost:/var/www/app/

connect expose localhost:3000 --name webhook-test --public
# → https://abc123.privateconnect.co

# Use that URL in Stripe/GitHub webhook settings
# Webhooks hit your local machine

# On your home server (runs 24/7)
connect daemon install
connect expose localhost:8096 --name jellyfin
connect expose 192.168.1.50:445 --name nas

# From anywhere in the world
connect reach jellyfin
# → http://localhost:8096 — your media server

# Share your environment
connect share
# → Share code: x7k9m2

# Teammate joins with one command
connect join x7k9m2
# → Same services, same ports. Done.

npx private-connect tunnel 3000
# → Creates temporary public tunnel (2hr expiry)

npx private-connect up 3000 5432 6379
# → npx private-connect join k7m2p9    (send this to your teammate)