Quick start

  1. Upload. Download the release zip, upload it to your host and unzip it. Point the domain's document root at the public/  folder.
  2. Run the installer. Visit https://your-domain/install . It checks the server, connects your database (SQLite needs no setup), runs the migrations and creates your admin account.
  3. Add a site. Enter the domain you want to measure. Tidemark shows a snippet for it.
  4. Paste the snippet into your site's <head> :
<script defer data-domain="example.com" src="https://stats.example.com/js/script.js"></script>

The dashboard waits for the first pageview and then opens by itself.

Tip:

Optional: add a cron job if you want queued ingestion or automatic data retention. Neither is needed to get started.

Try it with demo data

Running locally rather than on a host? Generate fake traffic first:

composer install && cp .env.example .env && php artisan key:generate
touch database/database.sqlite && php artisan migrate
php artisan tidemark:demo        # demo@example.com / password
php artisan serve