Installation
#Requirements
- PHP 8.2+
- Statamic 6.24.2+
- A writable database connection (SQLite, MySQL, MariaDB, or PostgreSQL)
ext-domext-libxml
#Composer
1composer require stillat/meerkat
#Blueprint and migrations
Publish the blueprint and migrations, then run the migrations:
1php please meerkat:install
Configuration, views, and Control Panel assets load automatically. Publish the configuration only when changing it:
1php artisan vendor:publish --tag=meerkat-config
To publish every Meerkat resource manually:
1php artisan vendor:publish --provider="Stillat\Meerkat\ServiceProvider"
2php artisan migrate
#Database connection
By default, Meerkat writes to your application's default database connection. To place comments on a dedicated connection, set MEERKAT_DATABASE_CONNECTION in your .env:
1MEERKAT_DATABASE_CONNECTION=meerkat
And define a connection of that name in config/database.php:
1'connections' => [
2 'meerkat' => [
3 'driver' => 'sqlite',
4 'database' => database_path('meerkat.sqlite'),
5 'prefix' => '',
6 ],
7],
#Verifying the install
The Control Panel should show Content → Comments. If it does not, run:
1php please meerkat:health
The health check verifies the database connection, comment blueprint, and required tables. If it fails, confirm that:
- The database configuration is correct
- You ran the migrations
- You published the Meerkat comment blueprint
#Next steps
- Configuration: moderation, storage, privacy, and integration settings
- Integrating Meerkat: add a comment form and thread
- Displaying comments: render and paginate comments
- Command reference: setup, import, maintenance, identity, and retention commands