Matomo auf einem Hetzner-Server installieren
  • Anmelden

    • Matomo auf einem Hetzner-Server installieren

    Dieser Leitfaden beschreibt die Standardvorgehensweise zur Einrichtung einer eigenen Matomo-Instanz (Web-Analytics) auf einem Hetzner-Webserver.


    1. Vorbereitung auf dem Server

    Bevor die eigentliche Installation beginnt, muss die grundlegende Infrastruktur (Speicherort, Domain und Datenbank) eingerichtet werden.

    1. Verzeichnis anlegen: Erstelle im Verzeichnis public_html/ einen neuen, leeren Ordner für die Instanz. Wähle einen aussagekräftigen Namen (z. B. aukom_matomo_live_ab_2026).
    2. Domain einrichten: Lege in der Hetzner-Verwaltungsumgebung eine neue Addon-Domain (oder Subdomain) an z.B report.aukom.info  und leite das Zielverzeichnis (Document Root) exakt auf den oben erstellten Ordner weiter.
    3. Datenbank erstellen: Lege eine neue MySQL-Datenbank für Matomo an.
      • Wichtig: Speichere die Zugangsdaten (Datenbankname, Benutzer und Passwort) sofort in KeePass (oder eurem Passwort-Manager).

    2. Matomo-Dateien auf den Server übertragen

    Es gibt zwei Wege, um die Matomo-Installationsdateien auf den Server zu bekommen. Die SSH-Methode ist in der Regel schneller.

    Option A: Über die Kommandozeile (SSH) - Empfohlen

    1. Verbinde dich per SSH mit dem Server und navigiere in das neu angelegte Verzeichnis.
    2. Lade Matomo herunter und entpacke es mit folgendem Befehl:

      wget https://builds.matomo.org/matomo.zip && unzip matomo.zip
    3. Dateipfade korrigieren: Beim Entpacken wird automatisch ein Unterordner namens matomo/ erstellt. Verschiebe alle Dateien aus diesem Unterordner eine Ebene nach oben direkt in dein Hauptverzeichnis und lösche den nun leeren Ordner sowie die ZIP-Datei:

    Option B: Manuell über FTP

    1. Lade dir die aktuelle ZIP-Datei von der offiziellen Website herunter: matomo.org/download
    2. Entpacke die ZIP-Datei lokal auf deinem Rechner.
    3. Verbinde dich per FTP-Programm (z. B. FileZilla) mit dem Server und lade den Inhalt des entpackten Ordners direkt in das neue Server-Verzeichnis hoch.

    3. Installation und Konfiguration im Browser

    Sobald die Dateien am richtigen Ort liegen, erfolgt die eigentliche Einrichtung über das Matomo-Interface.

    1. Setup starten: Rufe die neu angelegte Addon-Domain im Browser auf (z. B. https://report.aukom.info). Der Matomo-Installationsassistent startet automatisch.
    2. Datenbank verbinden: Trage die zuvor erstellten und im KeePass gespeicherten MySQL-Daten ein.
    3. Administrator anlegen: Erstelle die neuen Benutzerzugangsdaten für den Haupt-Administrator (auch diese direkt im KeePass hinterlegen).

    4. Tracking-Code einbinden

    Am Ende der Installation generiert Matomo einen JavaScript-Tracking-Code.

    • Kopiere diesen Script-Abschnitt und füge ihn auf der Ziel-Website (die getrackt werden soll) im Quelltext direkt vor dem schließenden </head>-Tag ein.