Laravel Cloud WebSockets

Introduction

Laravel Cloud offers a fully managed WebSocket infrastructure powered by Laravel Reverb clusters. Laravel Reverb is a Pusher-compatible WebSocket server that supports private channels, presence channels, client events, and more. Laravel and Symfony applications can use it to add real-time features. You can create Laravel Reverb powered WebSocket clusters directly from the Laravel Cloud dashboard (no external accounts needed) and attach them to your application’s environments.

Laravel Reverb

Laravel Reverb is an open source, high-performance WebSocket server designed specifically for Laravel applications. When running managed Laravel Reverb on Laravel Cloud, Reverb clusters are automatically provisioned and fully managed by Cloud, allowing you to avoid the time, complexity, and DevOps expertise typically required to set up and maintain a scalable and high-availability WebSocket server manually. See the pricing docs for details on concurrent connections, limitations, and pricing.

Creating clusters

To create a Laravel Reverb powered WebSocket cluster, go to your organization’s Resources page, click the WebSockets tab, then click + New WebSocket cluster. Laravel Cloud will prompt you to select a region and the maximum number of concurrent connections your cluster needs to be able to handle. Laravel Cloud will automatically create a default WebSocket application for you called main. To attach it to an environment, go to your application canvas and click Add resource > WebSockets. WebSocket applications allow you to segment and share your cluster capacity across multiple applications and environments. Once the WebSocket application has been attached to the environment, redeploy your application for the changes to take effect.

Connecting your application

Laravel
Symfony

Ensure your application has Laravel Reverb and Laravel Echo installed:

composer require laravel/reverb
npm install --save-dev laravel-echo pusher-js

Cloud automatically injects the Reverb environment variables needed by your application, including the frontend variables required by the Laravel Echo JavaScript client. No manual configuration is required.

REVERB_APP_ID=10001
REVERB_APP_KEY=********
REVERB_APP_SECRET=********
REVERB_HOST=ws-********-reverb.laravel.cloud
REVERB_PORT=443
REVERB_SCHEME=https
REVERB_VERIFY_SSL=true

VITE_APP_NAME="${APP_NAME}"

VITE_REVERB_APP_KEY="${REVERB_APP_KEY}"
VITE_REVERB_HOST="${REVERB_HOST}"
VITE_REVERB_PORT="${REVERB_PORT}"
VITE_REVERB_SCHEME="${REVERB_SCHEME}"

Cloud’s WebSocket clusters use the Pusher protocol, which is compatible with any Pusher-protocol client library. Ensure your application has the required packages installed:

composer require pusher/pusher-php-server
npm install pusher-js

Cloud automatically injects the Reverb environment variables when a WebSocket application is attached to your environment:

REVERB_APP_ID=10001
REVERB_APP_KEY=********
REVERB_APP_SECRET=********
REVERB_HOST=ws-********-reverb.laravel.cloud
REVERB_PORT=443
REVERB_SCHEME=https
REVERB_VERIFY_SSL=true

# config/services.yaml
services:
    Pusher\Pusher:
        arguments:
            $auth_key: '%env(REVERB_APP_KEY)%'
            $secret: '%env(REVERB_APP_SECRET)%'
            $app_id: '%env(REVERB_APP_ID)%'
            $options:
                host: '%env(REVERB_HOST)%'
                port: '%env(int:REVERB_PORT)%'
                scheme: '%env(REVERB_SCHEME)%'
                useTLS: true
                verify: '%env(bool:REVERB_VERIFY_SSL)%'

You can then inject Pusher\Pusher into any service or controller via autowiring.REVERB_APP_KEY and REVERB_HOST are safe to expose to the browser (for example, rendered into your frontend templates for the JS client). REVERB_APP_SECRET is used for server-side authentication only and should never be exposed publicly.After your first deployment, add your application’s Cloud domain to the WebSocket cluster’s allowed origins. Without this step, browser connections will fail silently.

Go to your organization’s Resources page and navigate to the WebSockets tab.
Click ”…” on your cluster and select Edit settings.
Add your application’s Cloud domain to the allowed origins list.

Editing, resizing, and splitting clusters

You can edit and resize your WebSocket cluster from your organization’s Resources page. Go to WebSocket clusters and click the … icon on your cluster, then click Edit settings. You can use a single WebSocket cluster across multiple applications by splitting the maximum concurrent connections you have provisioned to your cluster across multiple WebSocket applications.

You can choose an even distribution or manually configure a custom split.

Metrics

You may view your WebSocket metrics, such as Connection Count and Message Rate, from your organization’s Resources page. Navigate to the WebSockets tab and click the … icon for an active Reverb cluster. Then, click View metrics. Use the drop-down in the top right to drill down into the metrics of an individual application.

Detaching applications

If a WebSocket cluster is no longer needed by your application, you can detach it from your application canvas.

Detaching a WebSocket application from an environment does not delete the cluster or stop it from accruing usage charges.

Deleting clusters

You may delete a WebSocket cluster from your organization’s Resources page. Navigate to the WebSockets tab and click the … icon for the cluster you would like to delete. Then, click Delete cluster.

Other WebSocket providers

If you don’t want to use Laravel Reverb powered WebSocket clusters, you can pair Laravel Cloud with an external WebSocket provider like Pusher or Ably. Both are compatible with Laravel event broadcasting and Laravel Echo. You will, however, need to manage your WebSocket infrastructure and billing outside of Laravel Cloud and manage your environment variables manually.

Get started

Basics

Private Cloud

Resources

Monitoring

Billing

Other

Laravel Cloud WebSockets

Introduction

Laravel Reverb

Creating clusters

Connecting your application

Editing, resizing, and splitting clusters

Metrics

Detaching applications

Deleting clusters

Other WebSocket providers

​Introduction

​Laravel Reverb

​Creating clusters

​Connecting your application

​Editing, resizing, and splitting clusters

​Metrics

​Detaching applications

​Deleting clusters

​Other WebSocket providers

Introduction

Laravel Reverb

Creating clusters

Connecting your application

Editing, resizing, and splitting clusters

Metrics

Detaching applications

Deleting clusters

Other WebSocket providers