> ## Documentation Index
> Fetch the complete documentation index at: https://laraowl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Client integration

> Connect a Laravel application to your LaraOwl server.

To monitor an application, install the `laraowl/client` package into it and point it at your LaraOwl server. Once connected, the app immediately begins streaming telemetry — requests, exceptions, queries, jobs, and more.

<Note>
  You need a running LaraOwl server and a **project API token** first. Create a project and copy its token from **Project Settings → API Keys**. See [Getting started](/quickstart).
</Note>

## 1. Install the client package

In the Laravel application you want to monitor:

```bash theme={null}
composer require laraowl/client
```

## 2. Configure

Run the interactive setup command, which writes the required configuration for you:

```bash theme={null}
php artisan laraowl:install
```

Or add the values manually to the application's `.env`:

```dotenv theme={null}
LARAOWL_SERVER_URL=https://your-laraowl-server.com
LARAOWL_TOKEN=your_project_api_token
```

| Variable             | Description                                                                                  |
| -------------------- | -------------------------------------------------------------------------------------------- |
| `LARAOWL_SERVER_URL` | The base URL of your LaraOwl server.                                                         |
| `LARAOWL_TOKEN`      | The API token for the project this app reports to. Found in **Project Settings → API Keys**. |

<Warning>
  The API token maps each application to one project. Use a **separate token per application** so their data stays isolated in its own project dashboard.
</Warning>

## 3. Optional: forward application logs

To ship the application's logs into LaraOwl's centralized log viewer, add the `laraowl` channel to your log stack:

```dotenv theme={null}
LOG_STACK=stack,laraowl
```

That's it. Your application will immediately begin sending telemetry data to the LaraOwl server.

## Verify the connection

Generate some traffic by hitting a few routes, then open the project dashboard. Within seconds you should see requests, queries, and any exceptions appear in real time.

<Check>
  If nothing shows up, confirm the server's **queue worker** and **Reverb** process are running, and that `LARAOWL_SERVER_URL` is reachable from the monitored app. See [Troubleshooting](/troubleshooting#data-isnt-showing-up-in-the-dashboard).
</Check>

## What happens next

The client sends captured data to the server's `/api/ingest` endpoint over authenticated HTTP. The server queues it instantly and processes it in the background — so monitoring adds negligible overhead to your application. See [Architecture](/architecture) for the full data flow.