Frameworks

Tunnel your Vite, Next.js, Expo, Shopify or Laravel dev server

Most dev servers refuse an unknown host name or break hot reload behind a tunnel. Here are the settings that make each one work through InstaWormhole.

Terminal
npx @instawormhole/connector 3000

Shares the app on port 3000 at a public HTTPS address. The first run asks you to approve this computer in your browser.

Vite

Add the address to server.allowedHosts and set hmr to protocol wss on client port 443.

Next.js

Next.js 15 and later need the address in allowedDevOrigins for scripts and hot reload.

Expo, Shopify, Laravel

Advertise your address to Expo, pass it to the Shopify CLI, or set APP_URL in Laravel.

Vite

If the page shows Blocked request or a host-not-allowed message, add your tunnel's address to server.allowedHosts in vite.config, set server.hmr to protocol wss with clientPort 443, and restart the dev server. The page then loads through the public address and edits appear without a manual reload.

Next.js

Next.js 15 and later block development assets requested from other origins, which breaks hot reload and hydration. Add your tunnel's address to allowedDevOrigins in next.config and restart.

Expo

Run npx @instawormhole/connector 8081 for the Metro port, then start Expo with EXPO_PACKAGER_PROXY_URL set to your tunnel's address. Expo shows that address as the one to open on a device, instead of using expo start --tunnel.

Shopify CLI

The Shopify CLI starts its own tunnel by default. Connect a tunnel to your app's port first, then run shopify app dev with --tunnel-url set to your tunnel's address and port 443.

Laravel and PHP

Run php artisan serve on port 8000 and npx @instawormhole/connector 8000, then set APP_URL to your tunnel's address so generated links use it. In Laravel 11 and later, also trust the proxy in bootstrap/app.php.

Questions

Hot reload does not update through the tunnel. Why?
Hot reload uses a WebSocket. For Vite set the hmr option to wss on port 443; for Next.js add the address to allowedDevOrigins.

Share your local app in a minute

Free plan: 3 tunnels online at once and 5 GB a month. No card needed.