Mave Core ist die Open-Source-Videoplattform hinter Mave. Betreiben Sie Dashboard, Video-Uploads, Encoding-Pipeline, einbettbaren Player, API und Analytics auf Ihrer eigenen Infrastruktur. Metriken sind Bestandteil von Core.
Self-Hosting umfasst die gesamte Core-Plattform. Das frühere eigenständige Metrikprojekt ist nicht mehr der Einstieg für eine neue Installation: Core bietet Videoverwaltung und Analytics zusammen. Unter Videometriken erfahren Sie mehr über die Ereigniserfassung und Player-Konfiguration.
Core ist unter AGPL-3.0-or-later verfügbar; eine kommerzielle Lizenz ist ebenfalls erhältlich. SaaS-spezifische Abrechnung und Zahlungsabwicklung gehören nicht zu Core. Unter Open-Source-Mave finden Sie die verwalteten und selbstgehosteten Optionen.
Das Docker-Compose-Paket enthält Core, PostgreSQL für Anwendungsdaten, ClickHouse für Analytics, MinIO für S3-kompatiblen Medienspeicher, tusd für fortsetzbare Uploads und Caddy für Webzugriffe und HTTPS. Die Videoverarbeitung läuft lokal mit FFmpeg.
Sie verwalten Dienste, Speicher, E-Mail, Updates, Monitoring und Backups. Browserkomponenten werden standardmäßig vom CDN von Mave geladen. Browser benötigen daher Internetzugang, während Medien und Analytics auf Ihrer Installation bleiben.
Installieren Sie Docker mit Compose 2.24.4 oder neuer. Planen Sie zur Evaluierung mindestens 4 CPU-Kerne, 8 GB RAM und 20 GB freien Speicherplatz sowie zusätzlichen Platz für Medien ein.
git clone https://github.com/maveio/core.git
cd core
docker compose upDer erste Build kann etwas dauern. Warten Sie auf „Mave is ready“ und öffnen Sie den Einrichtungslink im Terminal. Geben Sie Ihre E-Mail-Adresse ein, um den ersten Workspace zu erstellen und sich anzumelden. Alternativ öffnen Sie localhost:4000 und geben den einmaligen Einrichtungscode manuell ein. Zeigen Sie die Begrüßung erneut an mit:
docker compose logs welcomeDer Schnellstart erzeugt automatisch Secrets und initialisiert die Datenbanken. Für die lokale Standardinstallation ist keine Umgebungsdatei erforderlich. Die Installation ist standardmäßig nur von Ihrem eigenen Rechner aus erreichbar.
Die erste Anmeldung funktioniert ohne E-Mail-Konfiguration. Konfigurieren Sie SMTP für spätere Anmeldungen per E-Mail und Teameinladungen anhand der E-Mail-Einstellungen in der Self-Hosting-Anleitung. Speichern Sie eigene Einstellungen in einer privaten .env im Stammverzeichnis des Repositorys und wenden Sie diese mit docker compose up -d an.
Konfigurieren Sie für öffentliches Hosting die DNS-Einträge Ihres Hostnamens und öffnen Sie die Ports 80/443. Ergänzen Sie vor dem Start diese Einstellungen in der .env im Stammverzeichnis und ersetzen Sie die Beispieldomain:
MAVE_BASE_URL=https://video.example.com
MAVE_CADDY_ADDRESS=video.example.com
MAVE_BIND_ADDRESS=0.0.0.0
MAVE_HTTP_PORT=80
MAVE_HTTPS_PORT=443Caddy verwaltet die HTTPS-Zertifikate. Verwenden Sie für öffentliches Hosting die Release-Konfiguration von Compose. Die vollständige Self-Hosting-Anleitung beschreibt Netzwerk, E-Mail, Speicherkonfiguration und Hostanforderungen für die Medienverarbeitung.
Laden Sie im Dashboard ein kleines Video hoch, warten Sie auf die Verarbeitung und prüfen Sie die Wiedergabe. Kopieren Sie den generierten Embed auf eine separate Seite und spielen Sie das Video dort ab. Öffnen Sie Data im Dashboard und warten Sie einige Sekunden, bis Analytics erscheinen.
Analytics verwenden ClickHouse und empfangen gebündelte HTTP-Events unter /v1/events. Verwenden Sie den Embed Ihrer eigenen Installation. Für eigene Integrationen lesen Sie die Metrikkonfiguration.
Führen Sie docker compose up -d im Stammverzeichnis aus, um die Dienste im Hintergrund zu starten. Mit docker compose stop stoppen Sie diese unter Erhalt der Daten. Daten und generierte Secrets liegen in persistenten Docker-Volumes. Sichern Sie beides zusammen mit Ihrer .env, sofern vorhanden. docker compose down -v löscht die Volumes Ihrer Installation.
Sichern Sie vor einem Upgrade Datenbanken und Medien und bewahren Sie die vorherige Konfiguration und das Image auf. Folgen Sie den Upgrade-Anweisungen für Ihre Installationsmethode. Bestehende Skriptinstallationen sollten ihr bisheriges Verzeichnis, ihren Projektnamen, ihre Volumes und ihre Startmethode beibehalten. Das Paket bietet keine automatisierten Backups, Hochverfügbarkeit oder Migrationen ohne Ausfallzeit.
Stellen Sie Einrichtungsfragen in der Discord-Community. Melden Sie Fehler bei Mave Core auf GitHub.
