Installation · 5 min read · Oct 18, 2025

So installieren Sie das Cachet-Statusseiten-System auf Debian 9

Cachet ist ein schönes und leistungsstarkes Open-Source-Statusseiten-System, das in PHP geschrieben ist und es Ihnen ermöglicht, Ausfallzeiten und Systemausfälle besser an Ihre Kunden, Teams und Aktionäre zu kommunizieren. Die Anwendung bietet Ihnen viele Funktionen, darunter: eine leistungsstarke JSON-API, Vorfallberichte, Metriken, Markdown-Unterstützung für Vorfallnachrichten, Benachrichtigungen für Abonnenten per E-Mail, Zwei-Faktor-Authentifizierung. In diesem Tutorial installieren wir das Cachet-Statusseiten-System mit PHP, Nginx, MariaDB und Composer.

Anforderungen

  • PHP-Version 5.5.9 oder höher
  • HTTP-Server mit PHP-Unterstützung (z. B.: Nginx, Apache, Caddy)
  • Composer
  • Eine unterstützte Datenbank: MySQL, PostgreSQL oder SQLite

Voraussetzungen

  • Ein Server, der Debian 9 ausführt.
    Ein Nicht-Root-Benutzer mit Sudo-Rechten.

Erste Schritte

Überprüfen Sie die Debian-Version:

lsb_release -ds  
# Debian GNU/Linux 9.5 (stretch)

Stellen Sie die Zeitzone ein:

timedatectl list-timezones  
sudo timedatectl set-timezone 'Region/Stadt'

Aktualisieren Sie die Pakete Ihres Betriebssystems:

sudo apt update && sudo apt upgrade -y

Installieren Sie die Pakete vim, git und socat:

sudo apt install -y vim git socat sudo

Schritt 1 - PHP installieren

Installieren Sie PHP und die erforderlichen PHP-Erweiterungen:

sudo apt install -y php7.0 php7.0-cli php7.0-fpm php7.0-common php7.0-xml php7.0-gd php7.0-zip php7.0-mbstring php7.0-mysql php7.0-pgsql php7.0-sqlite3 php7.0-mcrypt php-apcu

Überprüfen Sie die PHP-Version:

php --version  
# PHP 7.0.30-0+deb9u1 (cli) (built: Jun 14 2018 13:50:25) ( NTS )

Schritt 2 - MariaDB installieren und eine Datenbank für Cachet erstellen

Cachet unterstützt MySQL/MariaDB, PostgreSQL und SQLite3-Datenbanken. In diesem Tutorial verwenden wir MariaDB als Datenbankserver.

Installieren Sie den MariaDB-Datenbankserver:

sudo apt install -y mariadb-server

Überprüfen Sie die MariaDB-Version:

mysql --version  
# mysql  Ver 15.1 Distrib 10.1.26-MariaDB, für debian-linux-gnu (x86_64) mit readline 5.2

Führen Sie das Skript mysql_secure_installation aus, um die Sicherheit von MariaDB zu verbessern und das Passwort für den MySQL root-Benutzer festzulegen:

sudo mysql_secure_installation

Beantworten Sie jede der Fragen:

Geben Sie das aktuelle Passwort für root ein (für keines eingeben): Drücken Sie Enter  
Root-Passwort festlegen? [Y/n] Y  
Neues Passwort: Ihr_sicheres_Passwort  
Neues Passwort erneut eingeben: Ihr_sicheres_Passwort  
Anonyme Benutzer entfernen? [Y/n] Y  
Root-Login aus der Ferne verbieten? [Y/n] Y  
Testdatenbank und Zugriff darauf entfernen? [Y/n] Y  
Berechtigungstabellen jetzt neu laden? [Y/n] Y

Verbinden Sie sich mit der MySQL-Shell als root-Benutzer:

mysql -u root -p  
# Passwort eingeben  

Erstellen Sie eine leere MariaDB-Datenbank und einen Benutzer für Cachet und merken Sie sich die Anmeldeinformationen:

MariaDB [(none)]> CREATE DATABASE dbname;  
MariaDB [(none)]> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';  
MariaDB [(none)]> FLUSH PRIVILEGES;

Verlassen Sie MariaDB:

MariaDB [(none)]> exit

Ersetzen Sie dbname, username und password durch Ihre eigenen Namen.

Schritt 3 - Acme.sh-Client installieren und Let’s Encrypt-Zertifikat erhalten (optional)

Die Sicherung Ihrer Statusseite mit HTTPS ist nicht notwendig, aber es ist eine gute Praxis, den Datenverkehr Ihrer Website zu sichern. Um ein SSL-Zertifikat von Let’s Encrypt zu erhalten, verwenden wir den Acme.sh-Client. Acme.sh ist eine reine Unix-Shell-Software zum Erhalten von SSL-Zertifikaten von Let’s Encrypt mit null Abhängigkeiten.

Laden Sie Acme.sh herunter und installieren Sie es:

sudo mkdir /etc/letsencrypt  
git clone https://github.com/Neilpang/acme.sh.git  
cd acme.sh   
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail [email protected]  
cd ~

Überprüfen Sie die Acme.sh-Version:

/etc/letsencrypt/acme.sh --version  
# v2.8.0

Erhalten Sie RSA- und ECC/ECDSA-Zertifikate für Ihre Domain/Ihren Hostnamen:

# RSA 2048  
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d status.example.com --ocsp-must-staple --keylength 2048  
# ECDSA  
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d status.example.com --ocsp-must-staple --keylength ec-256

Nachdem Sie die obigen Befehle ausgeführt haben, befinden sich Ihre Zertifikate und Schlüssel in:

  • Für RSA: Verzeichnis /etc/letsencrypt/status.example.com.
  • Für ECC/ECDSA: Verzeichnis /etc/letsencrypt/status.example.com_ecc.

Schritt 4 - Nginx installieren und konfigurieren

Cachet kann gut mit vielen Webservern arbeiten. In diesem Tutorial haben wir Nginx ausgewählt.

Installieren Sie Nginx:

sudo apt install -y nginx

Überprüfen Sie die Nginx-Version:

sudo nginx -v  
# nginx version: nginx/1.10.3

Konfigurieren Sie Nginx für Cachet, indem Sie Folgendes ausführen:

sudo vim /etc/nginx/sites-available/cachet.conf

Und fügen Sie die folgende Konfiguration in die Datei ein:

server {  
  
  listen 80;  
  listen [::]:80;  
  
  server_name status.example.com;  
  
  root /var/www/cachet/public;  
  
  index index.php;  
  
  ssl_certificate /etc/letsencrypt/status.example.com/fullchain.cer;  
  ssl_certificate_key /etc/letsencrypt/status.example.com/status.example.com.key;  
  ssl_certificate /etc/letsencrypt/status.example.com_ecc/fullchain.cer;  
  ssl_certificate_key /etc/letsencrypt/status.example.com_ecc/status.example.com.key;  
  
  location / {  
    try_files $uri /index.php$is_args$args;  
  }  
  
  location ~ \.php$ {  
    include fastcgi_params;  
    fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;  
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  
    fastcgi_index index.php;  
    fastcgi_keep_conn on;  
  }  
  
}

Aktivieren Sie die neue cachet.conf-Konfiguration, indem Sie die Datei mit dem sites-enabled-Verzeichnis verlinken:

sudo ln -s /etc/nginx/sites-available/cachet.conf /etc/nginx/sites-enabled/

Testen Sie die NGINX-Konfiguration:

sudo nginx -t

Laden Sie Nginx neu:

sudo systemctl reload nginx.service

Schritt 5 - Composer installieren

Installieren Sie Composer, den PHP-Abhängigkeitsmanager, global:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"  
  
php -r "if (hash_file('SHA384', 'composer-setup.php') === '544e09ee996cdf60ece3804abc52599c22b1f40f4323403c44d44fdfdd586475ca9813a858088ffbc1f233e9b180f061') { echo 'Installer verifiziert'; } else { echo 'Installer beschädigt'; unlink('composer-setup.php'); } echo PHP_EOL;"  
  
php composer-setup.php  
  
php -r "unlink('composer-setup.php');"  
  
sudo mv composer.phar /usr/local/bin/composer

Überprüfen Sie die Composer-Version:

composer --version  
# Composer version 1.7.2 2018-08-16 16:57:12

Schritt 6 - Cachet installieren

Erstellen Sie ein Dokumentstammverzeichnis, in dem Cachet untergebracht werden soll:

sudo mkdir -p /var/www/cachet  

Navigieren Sie zum Dokumentstammverzeichnis:

cd /var/www/cachet

Laden Sie den Cachet-Quellcode mit Git herunter und wechseln Sie zur neuesten markierten Version:

git clone https://github.com/cachethq/Cachet.git .  
git tag -l  
git checkout v2.3.15

Kopieren Sie .env.example in die .env-Datei und konfigurieren Sie die Datenbank- und APP_URL-Einstellungen in der .env-Datei:

cp .env.example .env  
vim .env

Installieren Sie die Cachet-Abhängigkeiten mit Composer:

composer install --no-dev -o

Richten Sie den Anwendungsschlüssel ein, indem Sie Folgendes ausführen:

php artisan key:generate

Installieren Sie Cachet:

php artisan app:install

Ändern Sie den Eigentümer des Verzeichnisses /var/www/cachet in www-data:

sudo chown -R www-data:www-data /var/www/cachet

Öffnen Sie Ihre Website in einem Webbrowser und folgen Sie den Anweisungen auf dem Bildschirm, um die Cachet-Installation abzuschließen.

Schritt 7 - Vervollständigen Sie die Cachet-Einrichtung

Wählen Sie Cache- und Sitzungsdriver aus und konfigurieren Sie die Mail-Optionen:

Vervollständigen Sie die Cachet-Einrichtung

Konfigurieren Sie allgemeine Website-Einstellungen wie Website-Name, Domain, Zeitzone und Sprache:

Allgemeine Einstellungen von Cachet

Erstellen Sie ein Administratorkonto:

Admin-Konto hinzufügen

Danach sollten Sie eine Nachricht erhalten, dass Cachet erfolgreich konfiguriert wurde. Sie können das Cachet-Dashboard öffnen, indem Sie auf die Schaltfläche „Zum Dashboard gehen“ klicken:

Cachet wurde erfolgreich installiert

Die Installation und Einrichtung von Cachet wurde abgeschlossen.
Um auf das Cachet-Dashboard zuzugreifen, fügen Sie /dashboard zu Ihrer Website-URL hinzu.

Cachet Dashboard

Links

Share: X/Twitter LinkedIn

Erhalte neue Beiträge in deinem Posteingang.

Kein Spam. Jederzeit abmelden.