Skip to main content

VibeTunnel Docker Usage

Perfect for containerized development and instant terminal access to your code.

🚀 Quick Start

📂 How It Works

  1. Your code gets mounted to /workspace in the container
  2. VibeTunnel starts with full dev tools (git, vim, nano, htop, etc.)
  3. Terminal access via web browser at the tunnel URL
  4. All changes persist to your local filesystem

🌐 Tunnel Options

Cloudflare Quick Tunnel (No Auth Required)

Local Development (No Tunnel)

💡 Use Cases

Remote Development

Work on any machine and access via tunnel:

Docker Compose Development

Kubernetes Debugging

Teaching & Workshops

🔧 Container Features

Pre-installed Tools

  • Languages: Node.js 22, Python 3
  • Editors: vim, nano
  • Utils: git, curl, wget, htop, tree, jq
  • Tunnels: ngrok, cloudflared
  • Dev Tools: pnpm, typescript, ts-node, nodemon

Smart Entrypoint

  • Shows helpful usage if no args provided
  • Passes all arguments to VibeTunnel
  • Automatically binds to 0.0.0.0 for container access

Environment

  • Working directory: /workspace (mount your code here)
  • PATH includes /workspace/node_modules/.bin
  • Node.js tools available globally

🛡️ Security Notes

  • --no-auth disables authentication (only use for development)
  • For production, use proper authentication methods
  • Tunnel URLs are public - be careful with sensitive data
  • Consider using --enable-ssh-keys for better security

🎯 Perfect For

  • Remote pair programming
  • Code reviews in real-time
  • Teaching programming
  • Debugging in containers
  • Quick server access
  • Team collaboration
  • Live demonstrations
Your code stays local, but terminal access is global! 🌍