Tunnel

Overview

The oblien tunnel command exposes a local port through the Oblien edge, giving you an instant public URL for any service running on your machine.

oblien tunnel 3000

This creates a tunnel (if needed), issues a connection token, and connects — all in one command:

✓ Tunnel ready

  URL     https://my-app-x7k.preview.oblien.com
  Port    localhost:3000
  ID      42

  Connected — forwarding traffic. Press Ctrl+C to stop.

Commands

Expose a port

oblien tunnel <port> [flags]

Flag	Description
`--slug <slug>`	Custom subdomain slug
`--name <name>`	Display name for the tunnel
`--domain <domain>`	Custom base domain

If a tunnel for this port already exists, it reuses it instead of creating a new one.

List tunnels

oblien tunnel list

Displays a table with ID, name, port, URL, and status.

Show tunnel details

oblien tunnel status <id>

Delete a tunnel

oblien tunnel delete <id>

Prompts for confirmation before deleting.

Examples

# Basic — expose port 3000
oblien tunnel 3000

# Custom slug
oblien tunnel 8080 --slug my-api

# Custom name and domain
oblien tunnel 3000 --name "Dev Server" --domain preview.oblien.com

# Management
oblien tunnel list
oblien tunnel status 42
oblien tunnel delete 42

# JSON output
oblien tunnel list --json

SDK usage

The tunnel is also available programmatically via the SDK. See the Edge Tunnel API docs for both the one-liner and two-sided (server generates token, client connects) patterns.

On this page