Documentation

Everything you need to use DevNet.

Installation

Pick the one-liner for your platform:

Windows

PS> powershell -c "irm https://devnet.sh/install.ps1 | iex"

Installs a standalone binary — no Node.js required.

Mac / Linux

$ curl -fsSL https://devnet.sh/install.sh | bash

Detects your OS and architecture automatically.

npm

$ npm i -g devnet-cli

Requires Node.js 18+. Works on any platform.

Authentication

Log in with your DevNet account. Your credentials are verified by the relay server — nothing is stored locally except a session token.

devnet login

To log out:

devnet logout

Sharing a port

Share any local port with a single command. DevNet creates a random subdomain under tunnel.devnet.sh and proxies traffic to your machine.

devnet share 3000

When someone visits the tunnel URL for the first time, they see a Waiting for approval page. Your terminal will show the device details and prompt you to approve or deny.

Once approved, that device's browser session is remembered for the duration of the tunnel — no repeat prompts per page load.

Options

--ttl <duration>

Tunnel lifetime. Options: 15m, 1h, 24h. Default: 1h

--invite <email>

Email the tunnel URL to someone when the tunnel opens.

--password <secret>

Require visitors to provide a password before accessing the tunnel.

--allow-ip <ip...>

Whitelist one or more IPs. All other IPs are blocked.

Examples

Share port 3000 for 15 minutes:

devnet share 3000 --ttl 15m

Share and email a client:

devnet share 3000 --invite client@acme.com

Password-protect a tunnel:

devnet share 3000 --password supersecret

Restrict to your office IP:

devnet share 3000 --allow-ip 203.0.113.42

Uninstall

To remove DevNet from Windows:

Remove-Item "$env:LOCALAPPDATA\DevNet" -Recurse -Force

Then remove %LOCALAPPDATA%\DevNet from your user PATH via System Properties → Environment Variables.