Start free Dashboard

Run Tidemark your way.

Use Docker on your own server or homelab, or upload a zip to the PHP hosting you already have. Same dashboard, free forever, with your data in a database you control.

Run with DockerUpload to PHP hosting

Latest: v0.9.6 · Docker image for amd64 and arm64 · or PHP 8.3+ with SQLite, MySQL, MariaDB or PostgreSQL

Docker

For servers, VPSes and homelabs. One container with the scheduler built in; a Raspberry Pi works too.

  1. Save the file

    Name it docker-compose.yml and set APP_URL.

  2. Start it

    Run docker compose up -d.

  3. Create your admin account

    Open /install. Update later by pulling a newer image.

Docker guideImage on GitHub
docker-compose.yml
services:
  tidemark:
    image: ghcr.io/tidemark-analytics/tidemark:latest
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - tidemark-data:/data
    environment:
      APP_URL: https://stats.example.com
volumes:
  tidemark-data:

PHP hosting

For ordinary shared hosting and cPanel. No Node, no SSH, no terminal. It needs PHP 8.3+ with common extensions.

  1. Upload the zip

    Unzip the release. Point the domain at the public/ folder, or leave it: a bundled .htaccess forwards requests and blocks internals.

  2. Open /install

    Tidemark checks your server, connects a database, runs the migrations and creates your admin account.

  3. Add a cron job

    In cPanel, only if you want queued ingestion and data retention. Updates are one click from the dashboard.

Download v0.9.6Install guide

Then add one line to your site

Paste the snippet into your site’s <head>. The dashboard waits for the first pageview, then opens by itself. The script is about 2 KB gzipped and works with single-page apps out of the box.

index.html
<script defer data-domain="example.com"
  src="https://stats.example.com/js/script.js"></script>

Questions

Should I use Docker or the zip?

Either one gives you the same dashboard. Use Docker if you run a server, a VPS or a homelab: it is one container with the scheduler built in, updates are a docker compose pull, and it runs as a non-root user with everything that changes kept in one volume. Use the zip if you are on ordinary PHP hosting, where there is nothing to install beyond uploading files.

Does Tidemark really run on shared hosting?

Yes. You upload a zip with its dependencies bundled, open /install and follow the steps. It needs PHP 8.3 or newer and a handful of common extensions, and it works with SQLite, MySQL, MariaDB or PostgreSQL. No Node, Docker or SSH is required. If you would rather use containers, the Docker image does the same job.

Is self-hosting the same product as Cloud?

Yes. Cloud is this same open-source dashboard, run for you, with plans and billing added on top. Nothing in the dashboard is held back from the self-hosted version.

How do updates work?

On a PHP host, the dashboard checks for new releases and can install them in one click, or you can upload the new zip yourself. With Docker, pull the newer image and recreate the container. Either way your configuration and data are kept.

Can I move to Cloud later, or back?

Yes. Export a site from Site settings, then import the file into the other install. Imports can be repeated safely, and goals come along.

Stuck? Ask in the community on Discord. Prefer not to run it? Tidemark Cloud is the same thing, hosted.

Start measuring in two minutes.

Free plan, no credit card. No cookies, no footprints.

Start freeView live demo