Installation einer Self-hosted-Instanz

Installation einer Self-hosted-Instanz

Eine Self-hosted-Instanz läuft auf Ihrer Infrastruktur, Daten bleiben bei Ihnen. Der empfohlene Weg ist Docker über Laravel Sail. Die folgenden Schritte setzen voraus, dass Sie Zugriff auf das Self-hosted-Repository haben.

Anforderungen

• PHP 8.5 und höher,
• Docker und Docker Compose,
• Node.js 22 und höher und npm für das Frontend.

1. Code und Abhängigkeiten holen

Klonen Sie das Repository in einen Projektordner und installieren Sie die PHP-Abhängigkeiten über composer install. Halten Sie einen lokalen Composer bereit, auch wenn Sie später über Sail arbeiten möchten.

2. Umgebung konfigurieren

Kopieren Sie .env.example nach .env. Die Standardkonfiguration erwartet eine MariaDB-Datenbank in einem Container. Ports werden in .env gesetzt — Standardwerte sind zum Beispiel APP_PORT=8900, FORWARD_DB_PORT=3400, FORWARD_REDIS_PORT=6400 und VITE_PORT=5200. Generieren Sie dann den Anwendungsschlüssel über php artisan key:generate.

3. Container und Frontend starten

Bauen und starten Sie die Umgebung über ./vendor/bin/sail build --no-cache und ./vendor/bin/sail up -d. Die Frontend-Assets bereiten Sie über ./vendor/bin/sail npm install und ./vendor/bin/sail npm run build vor.

4. Daten initialisieren

Führen Sie php artisan app:fresh-install aus. Dies führt frische Migrationen mit Seedern durch und erstellt sofort die Standardseiten, Beiträge und weiteren Inhalte in der Instanz. In der Produktion bringt dieser Befehl die komplette Standardstruktur aus.

5. Erstes Deployment

Der Schnellstart in einer Docker-Umgebung wird auf der Seite Docker-Quick-Start beschrieben. Das Vorgehen für das erste Deployment auf einen Zielserver finden Sie unter Erstes Deployment und Produktions-Checkliste.

Möchten Sie keine eigene Instanz verwalten? Gehen Sie zum Managed-Modus oder sehen Sie sich den Vergleich beider Modi an.

Nächster Schritt: Weiter mit dem Docker-Quick-Start und prüfen Sie danach die Erste Deployment-Checkliste.