Installation

#Requirements

  • PHP 8.2+
  • Statamic 6.24.2+
  • A writable database connection (SQLite, MySQL, MariaDB, or PostgreSQL)
  • ext-dom
  • ext-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

Was this page helpful?