Einführung in die Installation des Kirby CMS

Voraussetzungen

Bevor Du mit der Installation des Kirby CMS beginnst, solltest Du sicherstellen, dass Dein Server die folgenden Anforderungen erfüllt:

• PHP-Version 7.2 oder höher

• Apache oder Nginx Webserver

• MySQL-Server (nur optional, falls Du die Datenbank-Erweiterung von Kirby verwenden möchtest)

Wenn Du nicht sicher bist, ob Dein Server diese Anforderungen erfüllt, wende Dich an Deinen Hosting-Provider oder Administrator, um weitere Informationen zu erhalten. Gern können wir Dich dabei auch unterstützen.

Schritt 1: Download von Kirby CMS

Der erste Schritt bei der Installation des Kirby CMS besteht darin, die neueste Version von der offiziellen Website herunterzuladen. Gehe dazu auf die Seite https://getkirby.com/try und lade das aktuelle Release-Paket herunter. Es steht Dir hierbei jeweils eine Variante mit Musterinhalten (Starterkit) und eine leere Variante (Plainkit) zur Verfügung. Zum Testen eignet sich die Starterkit-Variante mit Musterinhalten am Besten.

Das Release-Paket ist eine ZIP-Datei, die alle Dateien enthält, die Du benötigst, um Kirby zu installieren und zum Laufen zu bringen. Da Kirby dateibasiert arbeitet, ist keine Datenbank zur Installation zwingend notwendig.

Schritt 2: Entpacken des Release-Pakets

Nachdem Du das Release-Paket heruntergeladen hast, musst Du es auf einem Webserver entpacken. Du kannst dies entweder auf einem Computer lokal tun und dann die entpackten Dateien per FTP auf den Server übertragen oder direkt auf dem Server entpacken, wenn Du über eine SSH-Verbindung mit entsprechenden Zugriffsrechten verfügst.

Um das Release-Paket auf dem Server zu entpacken, lade es zunächst auf den Server per FTP oder SSH hoch und navigiere dann in das Verzeichnis, in welches Du Kirby installieren möchtest. Wenn Du es beispielsweise in das Verzeichnis /var/www/html/ installieren möchtest, navigiere zunächst in dieses Verzeichnis.

Öffne nun das Terminal der aktiven SSH-Verbindung und gib den folgenden Befehl ein, um das Release-Paket zu entpacken:

unzip kirby-3.9.1.zip

Schritt 3: Konfiguration der Verzeichnisstruktur

Nachdem Du das Release-Paket entpackt hast, musst Du die Verzeichnisstruktur von Kirby konfigurieren. Dazu müssen die folgenden Verzeichnisse vorhanden sein und ansonsten erstellt werden. Im Starterkit sind diese bereits vorhanden:

/site
/content
/assets

Das site-Verzeichnis enthält alle Dateien, die für die Anpassung und Konfiguration der Kirby CMS-Installation erforderlich sind. Das content-Verzeichnis enthält alle Inhalte der Website, während das assets-Verzeichnis alle Dateien enthält, die für das Styling (CSS) und weitere Funktionen der Website (JavaScript) erforderlich sind.

Um diese Verzeichnisse zu erstellen, navigiere per SSH in das Verzeichnis, in welches Du Kirby entpackt hast, und gib den folgenden Befehl im Terminal ein:

mkdir site content assets

Alternativ kannst du die Verzeichnisse natürlich auch im FTP-Programm deiner Wahl erstellen, solltest du über keinen SSH-Zugriff auf den Server verfügen.

Schritt 4: Konfiguration der Dateiberechtigungen

Dieser Befehl ändert die Berechtigungen für die Verzeichnisse site, content und assets, damit sie für den Webserver beschreibbar sind. Normalerweise sollten beim Erstellen der Verzeichnisse die Rechte aber bereits korrekt gesetzt sein.

chmod 777 site content assets

In der Regel kannst du diese Schreibrechte auch einfach mit einem FTP-Programm wie Filezilla oder Cyberduck für jedes Verzeichnis prüfen und definieren.

Schritt 5: Konfiguration der .htaccess-Datei

Das Kirby CMS verwendet eine .htaccess-Datei, um URLs umzuschreiben und SEO-freundliche URLs zu generieren. Diese Datei befindet sich im Stammverzeichnis des Kirby CMS. Um sicherzustellen, dass die .htaccess-Datei ordnungsgemäß funktioniert, solltest Du prüfen, ob der Webserver, bzw. dein Provider die Verwendung von .htaccess-Dateien zulässt.

Solltest Du einen Apache-Webserver verwenden, öffne einfach die httpd.conf-Datei und suche nach der folgenden Zeile:

AllowOverride None

Ändere diese Zeile in:

AllowOverride All

Wenn Du einen Nginx-Webserver verwendest, musst Du die nginx.conf-Datei bearbeiten und die folgenden Zeilen hinzufügen:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location = /favicon.ico {
    access_log off;
    log_not_found off;
}

location = /robots.txt {
    access_log off;
    log_not_found off;
}

location ~ \.php$ {
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
    fastcgi_index index.php;
    include fastcgi_params;
}

Schritt 6: Konfiguration der index.php-Datei

Die index.php-Datei ist die Hauptdatei des Kirby CMS, die alle Anfragen an Deine Website verarbeitet. Diese Datei befindet sich im Stammverzeichnis von Kirby.

Um Kirby spezifischer zu konfigurieren, kannst Du die index.php-Datei bearbeiten. Öffne dazu die Datei in einem Text- oder Code-Editor und suche nach der folgenden Zeile:

require __DIR__ . '/kirby/bootstrap.php';

Diese Zeile lädt die Bootstrap-Datei von Kirby. Füge als Beispiel nun unter dieser Zeile den folgenden Code hinzu, um Deine Website-URL zu definieren:

$kirby = new Kirby([
    'url' => 'https://example.com'
]);

Im Normalfall benötigst Du jedoch keine näheren Einstellungen an dieser Stelle innerhalb der index.php, denn Kirby bietet ab Version 3 für sämtliche Konfigurationen die Möglichkeitkeit eine config.php-Datei im config-Unterverzeichnis anzulegen.

/config/config.php

Schritt 7: Installation abschließen

Nachdem Du alle Konfigurationsschritte abgeschlossen hast, ist die Kirby CMS-Installation einsatzbereit. Öffne einfach einen Webbrowser und navigiere zur URL Deiner Website. Solltest Du nun die Standard-Startseite von Kirby sehen, war die Installation erfolgreich.

Fazit

Die Installation des Kirby CMS ist aufgrund seiner dateibasierten Inhaltsspeicherung einfach und völlig unkompliziert. Mit nur wenigen Schritten kannst Du das CMS auf Deinem Server installieren und anpassen. Wenn Du Schwierigkeiten hast, kannst Du jederzeit die offizielle Dokumentation des Kirby CMS oder das Support-Forum konsultieren. Natürlich unterstützen wir Dich auch gern dabei.

Es ist auch wichtig zu beachten, dass die Konfiguration von Kirby je nach Hosting-Umgebung variieren kann. Wenn Du Probleme beim Installieren oder Konfigurieren von Kirby hast, wende Dich zunächst an Deinen Webhosting-Anbieter oder Serveradministrator.

Nun kannst Du das Kirby CMS und seine Basisfunktionen ausgiebig testen. Den Adminbereich öffnest Du standardmäßig über den Pfad /panel der Website-URL. Also beispielsweise folgendermaßen:

www.example.com/panel

Beim ersten Mal, musst Du noch kurz einen Account erstellen. Gib dazu einfach Deine gewünschten Zugangsdaten ein und dann geht's schon los! Viel Spaß beim Testen!