tunnelup

Universal dev server + Cloudflare tunnel launcher

Features • Installation • Quick Start • Usage • Configuration • Supported Frameworks

tunnelup automatically detects your project type, starts your development server, and creates a Cloudflare tunnel to expose it to the internet. Perfect for sharing local development builds with teammates or testing webhooks.

Features

• Auto-detection - Automatically detects Next.js, Vite, Expo, Remix, Python/FastAPI, Django, Go, Docker Compose, Rust, and more
• Cloudflare Tunnels - Instantly create public URLs to share your local development server
• Multi-service Support - Run multiple services simultaneously, each with its own tunnel
• Zero Config - Works out of the box with smart defaults; optional configuration file for full control
• Port Detection - Automatically detects the port your dev server is running on

Installation

npm install -g tunnelup

You also need to install cloudflared:

# macOS
brew install cloudflared

# Linux (Arch)
yay -S cloudflared

# Other platforms
# See https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation/

Quick Start

# Just run in your project directory
tunnelup

# Or initialize a config file first
tunnelup init

Usage

# Start dev server with tunnel (auto-detect project type)
tunnelup

# Override port
tunnelup -p 8080

# Override dev command
tunnelup -c "npm run dev"

# Initialize configuration file
tunnelup init

Configuration

Create a tunnelup.config.json in your project root:

{
  "services": [
    {
      "name": "web",
      "port": 3000,
      "cmd": "npm run dev",
      "cwd": "."
    },
    {
      "name": "api",
      "port": 4000,
      "cmd": "uv run uvicorn main:app --reload",
      "cwd": "./api"
    }
  ]
}

Configuration Options

Option	Type	Description
services	array	Array of services to start
services[].name	string	Service name for display
services[].port	number	Expected port number
services[].cmd	string	Dev command to run
services[].cwd	string	Working directory (default: .)

Supported Frameworks

tunnelup automatically detects and configures these frameworks:

Framework	Detected By	Default Command
Next.js	package.json + next dependency	npm run dev
Vite	vite.config.js/ts	npm run dev
Expo	expo dependency	npm run dev
Remix	remix dependency	npm run dev
Node.js	package.json + dev script	npm run dev
Python FastAPI	pyproject.toml + fastapi	uv run uvicorn main:app --reload
Django	manage.py	python manage.py runserver
Go	go.mod	go run .
Docker Compose	docker-compose.yml	docker compose up
Rust	Cargo.toml	cargo run
Maven (Spring Boot)	pom.xml	mvn spring-boot:run
Gradle (Spring Boot)	build.gradle	./gradlew bootRun

How It Works

1. Detection - Scans your project for configuration files to identify the framework
2. Port Discovery - Monitors network ports to find the one your dev server opens
3. Server Start - Runs your dev command and waits for the server to be ready
4. Tunnel Creation - Launches Cloudflare tunnel to expose your local server
5. URL Display - Shows the public URL where your app is accessible

Requirements

• Node.js 18+
• cloudflared (installed and authenticated with cloudflared tunnel login)

Note

If you're not authenticated with Cloudflare, run cloudflared tunnel login before using tunnelup.