> ## 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.
# Introduction
> Self-hosted, full-stack monitoring for Laravel applications.
LaraOwl is an open-source, **self-hosted** monitoring platform built specifically for Laravel applications. You deploy it on your own infrastructure, point your apps at it, and get real-time observability across requests, exceptions, queries, jobs, and more — without your telemetry ever leaving your servers.
Drop a single Composer package into any Laravel app, connect it to your LaraOwl server, and start capturing data in minutes.
## Why LaraOwl?
Your data stays on your infrastructure. No third-party SaaS, no data egress, full ownership.
No per-seat or per-event pricing. Run it on hardware you already have and monitor unlimited projects.
Live dashboards over WebSockets (Laravel Reverb). No page refresh needed to see new events.
Purpose-built for Laravel — requests, jobs, queues, scheduled tasks, and Artisan commands out of the box.
## Key features
* **Full-stack observability** — requests, exceptions, database queries (with slow-query and N+1 detection), jobs, queues, commands, scheduled tasks, cache events, mail, notifications, outgoing HTTP calls, and centralized logs.
* **Real-time performance dashboard** — interactive time-series charts with flexible filters (1h, 24h, 7d, 14d, 30d, or custom ranges).
* **Real-time alerts** — route notifications to Slack, Discord, Telegram, email, or any webhook when a new exception appears, latency spikes, uptime drops, or a heartbeat stops reporting.
* **Uptime & heartbeat monitoring** — automatic health checks and cron/scheduled-task check-ins with instant down alerts.
* **Security & threat detection** — built-in WAF analysis (SQL injection, XSS, path traversal, and more) with risk scoring, plus optional Cloudflare firewall management.
* **Multi-tenant** — organize work into teams and projects, each with its own settings, API tokens, integrations, and data-retention policy.
* **Asynchronous ingestion** — incoming data is queued immediately for zero-latency API responses; processing and broadcasting happen in the background.
## How it works
```
┌──────────────────┐ HTTPS POST /api/ingest ┌──────────────────────┐
│ Your Laravel │ ──────────────────────────────▶ │ LaraOwl Server │
│ application │ (API token auth) │ Queue → Process → │
│ laraowl/client │ │ Store → Broadcast │
└──────────────────┘ └──────────────────────┘
```
1. The **client package** hooks into Laravel's container and captures telemetry (requests, exceptions, queries, jobs, and more).
2. Data is sent via authenticated HTTP `POST` to the server's `/api/ingest` endpoint.
3. The server **queues the payload immediately** and responds `200 OK` with zero processing delay.
4. A **queue worker** stores the records, groups issues, runs security analysis, and evaluates alert thresholds.
5. A **WebSocket event** is broadcast so the dashboard updates in real time.
## Get started
Check PHP, extension, and database requirements before you install.
Install the LaraOwl server via Docker or Composer.
Configure your environment, database, and Reverb credentials.
Create your first account, project, and connect an app.