Catch every exception before your users do.

Features

Everything you need to monitor exceptions and uptime — without SaaS billing or vendor lock-in.

Install

PHP 8.3+, Composer, and Node. Any SQL database Laravel supports.

git clone https://github.com/andreapollastri/boogle.git
cd boogle
composer run setup

The setup script installs Composer deps, creates .env, generates the app key, migrates, installs npm packages, and builds assets.

Manual install

composer install
cp .env.example .env
php artisan key:generate
php artisan migrate --force
npm install --ignore-scripts
npm run build

Quick start

From zero to a running panel in three steps.

Local stack

composer run dev

Starts the web server, queue listener, log tail, and Vite. For scheduler locally, also run php artisan schedule:work.

Client apps

Send exceptions from another Laravel application into this Boogle instance.

composer require andreapollastri/boogle-client
php artisan boogle:install

Set env vars from the project Installation page:

BOOGLE_KEY=<project_api_token>
BOOGLE_PROJECT_KEY=<project_key>
BOOGLE_SERVER=https://your-boogle-host.example/api/log

Laravel 11+

In bootstrap/app.php:

->withExceptions(function (Exceptions $exceptions) {
    Boogle::registerExceptionHandler($exceptions);
})

Laravel 9 / 10

In app/Exceptions/Handler.php register():

$this->reportable(function (Throwable $e) {
    Boogle::handle($e);
});

Verify with:

php artisan boogle:test

Uptime

Each project can ping a URL and open an outage issue when it fails.

• uptime_enabled — turn monitoring on or off
• uptime_url — optional; falls back to the project url

On failure Boogle records a ProjectOfflineException and emails. When the service returns, the issue moves to DONE and a recovery mail is sent. The project chart shows the last 30 days.

php artisan projects:check-uptime

Admin API

Base path /api/admin. Auth: Bearer <sanctum-token> from an admin user.

• Projects — list / create / show / update / delete
• Groups — list / create / show / update / delete
• Exceptions — global list, by project, show, update status
• Ingestion — POST /api/log (project key + token, no admin bearer)

Interactive docs: /api/docs. Spec file: public/openapi.json (API v1.3.0).

Create tokens from the panel profile page.

Scheduler

One cron entry drives digests, uptime checks, and pruning.

* * * * * cd /path-to-boogle && php artisan schedule:run >> /dev/null 2>&1

Production

Deploy without surprises. Cache config, keep the queue and scheduler running.

php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan queue:work --sleep=3 --tries=3 --timeout=120