dhimanparas20/itcyou repository overview

⁠itcyou - Lightweight Tunnel Client for Docker

Expose your localhost to the internet in seconds 🚀

⁠What is itcyou?

itcyou⁠ is a modern tunneling service that creates secure HTTPS URLs for your local development servers. Think ngrok, but cleaner and faster.

This Docker image provides a ~20MB lightweight Alpine-based container to expose your local services to the internet instantly.

⁠🚀 Quick Start

⁠Docker Run (30 seconds)

# Random subdomain
docker run -d --rm --network host --name itcyou \
  -e ITCYOU_PORT=3000 \
  --name ddns \
  dhimanparas20/itcyou:latest

# Custom subdomain
docker run -d --rm --network host --name itcyou \
  -e ITCYOU_PORT=3000 \
  -e ITCYOU_SUBDOMAIN=myapp \
  dhimanparas20/itcyou:latest

# With authentication (reserved subdomain)
docker run -d --rm --network host --name itcyou \
  -e ITCYOU_PORT=3000 \
  -e ITCYOU_SUBDOMAIN=myreservedname \
  -e ITCYOU_TOKEN=itc_yourapikey \
  dhimanparas20/itcyou:latest

⁠Docker Compose (Linux)

services:
  itcyou:
    image: dhimanparas20/itcyou:latest
    container_name: itcyou-tunnel
    restart: unless-stopped
    network_mode: host
    environment:
      ITCYOU_PORT: "3000"
      ITCYOU_SUBDOMAIN: "myapp"
      # ITCYOU_TOKEN: "itc_yourapikey"

⁠📋 Environment Variables

⁠💡 Common Use Cases

• Web Development: Share local dev servers with your team
• Webhook Testing: Test Stripe, GitHub, or other webhooks locally
• Mobile Testing: Preview apps on real devices
• Database Sharing: Expose PostgreSQL/MySQL for remote access
• IoT Development: Secure tunnels for device communication

⁠🐧 Requirements

• Linux only — Requires --network host which doesn't work on macOS/Windows Docker Desktop
• Docker 20.10+
• Your target service must be running before starting the tunnel

⁠🔗 Links

• 📦 Docker Hub: https://hub.docker.com/r/dhimanparas20/itcyou⁠
• 💻 GitHub: https://github.com/dhimanparas20/itcyou-docker⁠
• 🌐 Official Site: https://it.cyou/⁠

⁠📝 License

MIT License - See GitHub repository for details.

Made with ❤️ by Paras Dhiman⁠