Share a Laravel app

Share your Laravel app from php artisan serve with a public HTTPS URL, with generated links pointing at the tunnel.

Before you beginCopy Anchor Link

• Node.js 18 or later
• A Horizon account and the CLI (see Getting started)
• A reserved subdomain for -s. Reserve one on the Subdomains page.
• A Laravel 11 or later app. The bootstrap/app.php code below uses its middleware API.

php artisan serve

hrzn tunnel http://localhost:8000 -s my-app

HORIZON: Tunnel connected
  URL          https://my-app.hrzn.run (reserved)
  Forwarding   http://localhost:8000
  Request log  https://hrzn.run/dashboard/tunnels/my-app

use Illuminate\Foundation\Configuration\Middleware;
use Illuminate\Http\Request;

->withMiddleware(function (Middleware $middleware): void {
    $middleware->trustProxies(
        at: '*',
        headers: Request::HEADER_X_FORWARDED_HOST,
    );
})

use Illuminate\Support\Facades\URL;

public function boot(): void
{
    if ($this->app->environment('local')) {
        URL::forceScheme('https');
    }
}

APP_URL=https://my-app.hrzn.run

Check it worksCopy Anchor Link

Add a route that prints the URL Laravel generates.

use Illuminate\Support\Facades\Route;

Route::get('/where', fn () => url('/'));

Open https://my-app.hrzn.run/where. On the first visit Horizon shows a Before you continue page. Select Continue to site. The page prints https://my-app.hrzn.run. The Horizon terminal prints:

  GET     200  /where

TroubleshootingCopy Anchor Link

Links start with http://127.0.0.1:8000Copy Anchor Link

Laravel isn't trusting X-Forwarded-Host. Check trustProxies in bootstrap/app.php and that the headers include Request::HEADER_X_FORWARDED_HOST.

Links start with http:// instead of https://Copy Anchor Link

Check that URL::forceScheme('https') runs. It's inside an environment('local') check, so APP_ENV must be local.

Scripts and styles don't loadCopy Anchor Link

If you run npm run dev, Vite serves assets from your own machine, which a visitor can't reach. Stop it and run npm run build instead. Laravel then serves the built files through the tunnel.

The URL changed after a restartCopy Anchor Link

You started the tunnel without -s, so Horizon gave you a new random subdomain. Restart with -s my-app and update APP_URL. -s needs a subdomain you reserved, see Pricing.

Nothing reaches your appCopy Anchor Link

• Check that the Horizon terminal is still running. If its last line is Connection lost. Reconnecting…, wait for Reconnected.
• Check that php artisan serve listens on port 8000, the port in your hrzn tunnel command.

Next stepsCopy Anchor Link

• Read Laravel's guide to configuring trusted proxies.
• Share a different stack: Rails or Django.