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 -yInstallieren Sie die Pakete vim, git und socat:
sudo apt install -y vim git socat sudoSchritt 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.2Fü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_installationBeantworten 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] YVerbinden 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)]> exitErsetzen 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.0Erhalten 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-256Nachdem 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.3Konfigurieren Sie Nginx für Cachet, indem Sie Folgendes ausführen:
sudo vim /etc/nginx/sites-available/cachet.confUnd 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 -tLaden Sie Nginx neu:
sudo systemctl reload nginx.serviceSchritt 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:12Schritt 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/cachetLaden 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.15Kopieren 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 .envInstallieren Sie die Cachet-Abhängigkeiten mit Composer:
composer install --no-dev -oRichten Sie den Anwendungsschlüssel ein, indem Sie Folgendes ausführen:
php artisan key:generateInstallieren 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:

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

Erstellen Sie ein Administratorkonto:

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:

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

Links
Erhalte neue Beiträge in deinem Posteingang.
Kein Spam. Jederzeit abmelden.