Installation

Require the package with Composer. The service provider and the Plausible facade alias are auto-discovered, and the four Roundly companion packages it builds on are installed automatically:

composer require roundly-consulting/plausible-for-laravel

Add your instance URL, API key and — optionally — a default site to .env. The key is for the Stats and Sites APIs; capturing events needs only the URL. That is all the configuration most apps need:

PLAUSIBLE_URL=https://plausible.io
PLAUSIBLE_API_KEY=your-api-key
PLAUSIBLE_SITE=my-site.com

The config file is optional — every key is env-backed. Publish it only to override defaults:

php artisan vendor:publish --tag="plausible-config"

To customise the tracking-script markup, publish the view — Plausible::script(), @plausibleScript and <x-plausible-script> all render it:

php artisan vendor:publish --tag="plausible-views"

There are no migrations — the package stores nothing in your database.

Verify the connection

Once the env is set, check configuration and connectivity in one command. It fails when the URL or key is missing, the instance is unreachable, or the key is refused — add --site= to verify a Stats API key against that site:

php artisan plausible:health