Laravel Sail
Run Buggregator next to your Sail containers. Your app then sends mail, errors, logs and dump() output to it.
Checked with Laravel 13.42, Sail 1.70 and sentry-laravel 4.30 against Buggregator 2.10.0.
1. Add the service
Sail keeps its services in compose.yaml (older apps: docker-compose.yml). Add buggregator under services::
buggregator:
image: 'ghcr.io/buggregator/server:2.11.0'
ports:
- '127.0.0.1:8000:8000'
networks:
- sail- The tag is pinned (
2.11.0). Change it on purpose when you upgrade, not by surprise. - Only the web UI port is published. Your app reaches mail, logs and dumps over the
sailnetwork by the service namebuggregator, so ports 1025, 9912 and 9913 do not need to be open on your machine. - Sail's
mailpitservice also takes port 1025 on your machine. Both can run: Buggregator does not publish 1025. You can removemailpitonce mail goes to Buggregator.
If APP_PORT is 8000, publish the UI on another port, e.g. '127.0.0.1:8001:8000'.
Start it: ./vendor/bin/sail up -d.
2. Point Laravel at it
Mail
MAIL_MAILER=smtp
MAIL_HOST=buggregator
MAIL_PORT=1025Errors (Sentry)
Install the SDK: ./vendor/bin/sail composer require sentry/sentry-laravel.
SENTRY_LARAVEL_DSN=http://sentry@buggregator:8000/1
SENTRY_TRACES_SAMPLE_RATE=1.0Laravel 11 and later also need one line in bootstrap/app.php. Without it, exceptions are not reported:
->withExceptions(function (Exceptions $exceptions): void {
\Sentry\Laravel\Integration::handles($exceptions);
})Logs
Add a socket channel to config/logging.php, as in Monolog → Laravel, then:
LOG_CHANNEL=socket
LOG_SOCKET_URL=buggregator:9913If Buggregator is not running, this channel throws an error, and even artisan commands fail with «Failed connecting to buggregator:9913». Set these lines only in your local .env.
Dumps
VAR_DUMPER_FORMAT=server
VAR_DUMPER_SERVER=buggregator:9912dump() and dd() now go to Buggregator instead of the page or the console.
3. Check it
Open http://127.0.0.1:8000. Then run something that mails, logs, dumps and fails. For example, add this to routes/console.php:
Artisan::command('buggregator:check', function () {
\Illuminate\Support\Facades\Mail::raw('Hello', fn ($m) => $m->to('dev@example.com')->subject('Check'));
\Illuminate\Support\Facades\Log::info('Hello from Laravel');
dump(['hello' => 'Buggregator']);
throw new RuntimeException('Check error');
});Run ./vendor/bin/sail artisan buggregator:check. You should now see an email «Check», a log record «Hello from Laravel», a dump, and a Sentry error «Check error». The error is also logged, so a second log record shows it.