doTunnel

Expose your local server to the internet without configuring firewalls or port forwarding. Dotunnel creates a secure HTTP tunnel so you can share your localhost with the internet in seconds.

Wanna test a webhook ? quick share/demo for webapp , API , Test on mobile ? or sharing anything running on your localhost ? Dotunnel is here for u , easy and fast .

Features

• HTTP tunneling
• Zero firewall or port-forwarding setup
• Single-command startup with npx dotunnel
• Runs on Cloudflare Edge network for low latency (⚡ Blazingly fast!)

Quick Start

Run without installation

npx dotunnel

By default, this will:

1. Prompt you for your local port (e.g.: 3000)
2. Ask for a name for your proxy (e.g.: my-app)
3. Output a public URL (e.g. https://my-app-prxy.jounaid.dev)
4. ✅ Forward requests from the public URL to your local server

Example Usage

When you run npx dotunnel, you’ll see:

$ npx dotunnel


? Enter the local port of the service to expose (e.g., 8000): 3000
? Enter a name for the proxy (e.g., todo): todo-api


🌐 Forwarding to: http://localhost:3000
🔗 Public URL:    https://todo-api-prxy.jounaid.dev

CLI Flags

All options can be provided as CLI flags, skipping the interactive prompt:

| Flag | Description | |-----------------------|-----------------------------------------| | -p, --port <number> | Local port to expose | | -n, --name <proxy> | Proxy name (subdomain) | | -b, --base-url <host> | Base host for the tunnel server | | -d, --debug | Enable debug logging | | -h, --help | Display help for command |

npx dotunnel --port 3000 --name my-app

https://my-app-prxy.jounaid.dev pointing to http://localhost:3000

Install globally

npm install -g dotunnel
dotunnel

Use the -g or --global flag to install once and run via dotunnel instead of npx.

Contributing

1. Fork this repository
2. Create a feature branch (git checkout -b feature-name)
3. Commit your changes (git commit -m "Add new feature")
4. Push to the branch (git push origin feature-name)
5. Open a Pull Request