Installation

Bludit 3.22 installieren: vollständige Anleitung vom Upload bis zum ersten Backup

Schritt für Schritt: Voraussetzungen, Upload, Unterverzeichnis, RewriteBase, erster Login, Funktionstest und Backup.

2 Minuten Lesezeit

Bludit lässt sich ohne Datenbankserver installieren. Trotzdem lohnt eine saubere Vorbereitung: PHP-Version und Module prüfen, Zielverzeichnis festlegen, Rewrite-Verhalten verstehen und vor dem ersten Login bereits entscheiden, ob die Installation im Domain-Root oder in einem Unterverzeichnis liegt.

Dieses Tutorial führt eine Neuinstallation so durch, dass später Themes, Plugins, Uploads und Gutenberg sauber funktionieren. Es orientiert sich an Bludit 3.22 und an der aktuellen englischen Dokumentation, die PHP 8.0 oder höher sowie mbstring, GD, DOM und JSON nennt.

1. Voraussetzungen prüfen

KomponenteWarum wichtig
PHP 8.0+führt Bludit, Plugins und Themes aus
mbstringUTF-8 und mehrbytefähige Textoperationen
GDBildverarbeitung und Vorschaubilder
DOMXML/DOM-Funktionen
JSONFlat-File-Datenbanken und Datenaustausch
mod_rewrite / Rewrite-Modulsprechende URLs und Routing

Auf Shared Hosting kannst du die Werte meist im Hosting-Panel sehen. Zusätzlich besitzt Bludit einen versteckten Entwicklerbereich unter /admin/developers, in dem Laufzeitinformationen, Konstanten und geladene Erweiterungen sichtbar sind.

2. Dateien hochladen

  1. Aktuelles Bludit-ZIP herunterladen und lokal entpacken.
  2. Den Inhalt des entpackten Ordners in das gewünschte Webverzeichnis laden.
  3. Im Root wäre die Site beispielsweise unter https://example.org/ erreichbar; im Unterverzeichnis bludit unter https://example.org/bludit/.
  4. Die URL im Browser öffnen und den Installer ausführen.

3. Installation im Unterverzeichnis

Wenn Pretty URLs oder /admin im Unterordner 404 liefern, prüfe zuerst die .htaccess. Bei einer Installation unter /bludit/ kann folgende Basis nötig sein:

# Base directory
RewriteBase /bludit/

Die Base muss exakt zum öffentlichen Pfad passen. Eine Installation in /cms/ braucht entsprechend RewriteBase /cms/. Nach einer Änderung den Browsercache leeren und direkte Seiten-URLs testen.

4. Direkt nach dem Installer

  • Zeitzone unter den allgemeinen Einstellungen kontrollieren.
  • Ein starkes Administrator-Passwort setzen und keine Zugangsdaten in Projekt-ZIPs weitergeben.
  • Unter Inhalte einen Testbeitrag anlegen.
  • Ein Bild hochladen und prüfen, ob ein Thumbnail erzeugt wird.
  • Pretty URL, Kategorie, statische Seite und Admin-Login testen.
  • Ein erstes Backup von bl-content/ anlegen.

5. Wo Bludit seine Daten speichert

Anders als WordPress benötigt Bludit keine MySQL-Datenbank. Seiten liegen unter bl-content/pages/, Index- und Einstellungsdaten unter bl-content/databases/, Uploads unter bl-content/uploads/ und Plugin-Arbeitsdaten unter bl-content/workspaces/. Genau deshalb ist bl-content der wichtigste Backup-Baustein.

Fehlercheck nach der Installation

  • Weiße Seite oder Fatal Error: PHP-Version und Error-Log prüfen.
  • Umlaute/Zeichenprobleme: mbstring prüfen.
  • Bilder ohne Thumbnails: GD und Schreibrechte prüfen.
  • 404 bei Unterverzeichnis: RewriteBase und Server-Rewrite prüfen.
  • Admin lädt, Frontend nicht: Theme aktivieren bzw. PHP-Fehler im Theme prüfen.

Quellen und weiterführende Dokumentation