{
  "schema_version": 1,
  "generated_at": "2026-10-22T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/matomo",
  "slug": "matomo",
  "name": "Matomo",
  "tagline": "Web analytics platform that stores visit data in your own database and shows reports in a web app.",
  "replaces": {
    "summary": "Paid web analytics services, such as Google Analytics.",
    "products": [
      {
        "slug": "google-analytics",
        "name": "Google Analytics",
        "vendor": "Google",
        "url": "https://openlogs.fyi/alternatives/google-analytics"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "PHP"
    },
    {
      "kind": "database",
      "name": "MariaDB"
    }
  ],
  "deployment_methods": [
    "docker_compose"
  ],
  "requirements": {
    "min_ram_mb": null,
    "min_cpu_cores": null,
    "source_url": null
  },
  "license": {
    "spdx": "GPL-3.0",
    "class": "osi",
    "source_url": "https://github.com/matomo-org/matomo/blob/476e22b8748fda6559d5e8612f0ad1169738dc99/LICENSE"
  },
  "business_model": {
    "value": "unknown",
    "notes": "The README at the pinned commit does not state a business model, so it stays unknown.",
    "source_url": "https://github.com/matomo-org/matomo/blob/476e22b8748fda6559d5e8612f0ad1169738dc99/README.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "medium",
    "reason": "2 services (1 database or broker: mariadb), 2 volume mounts, 2 env values to set, no elevated host access. Heuristic score 4 of 11: medium."
  },
  "repository": {
    "owner": "matomo-org",
    "name": "matomo",
    "url": "https://github.com/matomo-org/matomo"
  },
  "compose_check": {
    "status": "config_ok",
    "validated_at": "2026-10-22",
    "summary": "config_ok on 2026-10-22"
  },
  "recipe": {
    "version": 1,
    "source_path": ".examples/apache/compose.yml",
    "source_repo": "matomo-org/docker",
    "source_commit_sha": "d27aefa7dfb9dff64500db6b648b3b75470d3fc7",
    "source_kind": "packaging_repo",
    "source_url": "https://github.com/matomo-org/docker/blob/d27aefa7dfb9dff64500db6b648b3b75470d3fc7/.examples/apache/compose.yml"
  },
  "install_steps": [
    {
      "order": 1,
      "kind": "prerequisite",
      "language": "text",
      "label": "Docker with the Compose plugin",
      "body": "A host with Docker and the Docker Compose plugin. This entry runs from a compose file.",
      "source_url": "https://github.com/matomo-org/docker/blob/d27aefa7dfb9dff64500db6b648b3b75470d3fc7/.examples/apache/compose.yml",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "compose",
      "language": "yaml",
      "label": "Save the compose file as compose.yml",
      "body": "---\nservices:\n  db:\n    image: mariadb:lts\n    command: --max-allowed-packet=64MB\n    restart: always\n    volumes:\n      - db:/var/lib/mysql:Z\n    environment:\n      - MARIADB_AUTO_UPGRADE=1\n      - MARIADB_DATABASE=matomo\n      - MARIADB_DISABLE_UPGRADE_BACKUP=1\n      - MARIADB_INITDB_SKIP_TZINFO=1\n      - MARIADB_PASSWORD=${MARIADB_PASSWORD}\n      - MARIADB_ROOT_PASSWORD=${MARIADB_ROOT_PASSWORD}\n      - MARIADB_USER=matomo\n\n  app:\n    image: matomo\n    restart: always\n    volumes:\n#     - ./config:/var/www/html/config:z\n#     - ./logs:/var/www/html/logs:z\n      - matomo:/var/www/html:z\n    depends_on:\n      - db\n    environment:\n      - MATOMO_DATABASE_ADAPTER=mysql\n      - MATOMO_DATABASE_DBNAME=matomo\n      - MATOMO_DATABASE_HOST=db\n      - MATOMO_DATABASE_PASSWORD=${MARIADB_PASSWORD}\n      - MATOMO_DATABASE_TABLES_PREFIX=matomo_\n      - MATOMO_DATABASE_USERNAME=matomo\n    ports:\n      - 8080:80\n\nvolumes:\n  db:\n  matomo:\n",
      "source_url": "https://github.com/matomo-org/docker/blob/d27aefa7dfb9dff64500db6b648b3b75470d3fc7/.examples/apache/compose.yml",
      "validation_status": "config_ok"
    },
    {
      "order": 3,
      "kind": "env",
      "language": "text",
      "label": "Set the values the compose file needs",
      "body": "These variables have no default in the compose file: MARIADB_PASSWORD, MARIADB_ROOT_PASSWORD. Compose reads them from the shell or from a .env file next to the compose file.",
      "source_url": "https://github.com/matomo-org/docker/blob/d27aefa7dfb9dff64500db6b648b3b75470d3fc7/.examples/apache/compose.yml",
      "validation_status": "unvalidated"
    },
    {
      "order": 4,
      "kind": "shell",
      "language": "bash",
      "label": "Start it",
      "body": "docker compose up -d",
      "source_url": "https://github.com/matomo-org/docker/blob/d27aefa7dfb9dff64500db6b648b3b75470d3fc7/.examples/apache/compose.yml",
      "validation_status": "unvalidated"
    },
    {
      "order": 5,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:8080. The compose file publishes host port 8080 for the app service.",
      "source_url": "https://github.com/matomo-org/docker/blob/d27aefa7dfb9dff64500db6b648b3b75470d3fc7/.examples/apache/compose.yml",
      "validation_status": "unvalidated"
    }
  ],
  "notes": [
    {
      "kind": "gotcha",
      "title": "Some images use the latest tag or no tag",
      "body": "Images without a pinned version: app: matomo (no tag). A later pull can get a different version.",
      "source_url": "https://github.com/matomo-org/docker/blob/d27aefa7dfb9dff64500db6b648b3b75470d3fc7/.examples/apache/compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file publishes host ports",
      "body": "Host ports: 8080 (app). A port without a host address listens on all host network interfaces.",
      "source_url": "https://github.com/matomo-org/docker/blob/d27aefa7dfb9dff64500db6b648b3b75470d3fc7/.examples/apache/compose.yml",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 21973,
    "forks": 2920,
    "open_issues": 2561,
    "last_push": "2026-10-22",
    "days_since_push": 0,
    "latest_release": "5.14.2",
    "latest_release_date": "2026-10-22",
    "days_since_release": 0
  },
  "links": {
    "html": "https://openlogs.fyi/tools/matomo",
    "markdown": "https://openlogs.fyi/tools/matomo.md",
    "json": "https://openlogs.fyi/tools/matomo.json"
  },
  "updated_at": "2026-10-22"
}
