Mave Core is het open-source videoplatform achter Mave. Draai het dashboard, video-uploads, de encodingpipeline, de insluitbare speler, API en analytics op infrastructuur die je zelf beheert. Metrics zijn onderdeel van Core.
Zelf hosten omvat het volledige Core-platform. Het voormalige losse metricsproject is niet langer het startpunt voor een nieuwe installatie: Core biedt videobeheer en analytics samen. Bekijk videometrics voor het verzamelen van events en het instellen van de speler.
Core is beschikbaar onder AGPL-3.0-or-later; er is ook een commerciële licentie beschikbaar. SaaS-specifieke facturatie en betalingsverwerking vallen buiten Core. Bekijk open-source Mave voor de beheerde en zelfgehoste opties.
De Docker Compose-bundel bevat Core, PostgreSQL voor applicatiegegevens, ClickHouse voor analytics, MinIO voor S3-compatibele mediaopslag, tusd voor hervatbare uploads en Caddy voor webverkeer en HTTPS. Videoverwerking draait lokaal met FFmpeg.
Je beheert zelf de services, opslag, e-mail, updates, monitoring en back-ups. Browsercomponenten laden standaard vanaf de CDN van Mave. Browsers hebben dus internettoegang nodig, terwijl media en analytics op je eigen installatie blijven.
Installeer Docker met Compose 2.24.4 of nieuwer. Reken voor evaluatie op minimaal 4 CPU-cores, 8 GB RAM en 20 GB vrije schijfruimte, plus ruimte voor je media.
git clone https://github.com/maveio/core.git
cd core
docker compose upDe eerste build kan even duren. Wacht op “Mave is ready” en open de installatielink in je terminal. Vul je e-mailadres in om de eerste workspace aan te maken en in te loggen. Je kunt ook localhost:4000 openen en de eenmalige installatiecode zelf invoeren. Toon het welkomstbericht opnieuw met:
docker compose logs welcomeDe quickstart genereert automatisch secrets en initialiseert de databases. Voor de standaard lokale installatie heb je geen omgevingsbestand nodig. De installatie is standaard alleen vanaf je eigen computer bereikbaar.
De eerste keer inloggen werkt zonder e-mailconfiguratie. Configureer SMTP voor latere inlogmails en teamuitnodigingen met de e-mailinstellingen uit de self-hostinghandleiding. Zet aangepaste instellingen in een privébestand .env in de hoofdmap van de repository en pas ze toe met docker compose up -d.
Configureer voor publiek hosten de DNS van je domein en stel poorten 80/443 open. Voeg vóór het starten deze instellingen toe aan de .env in de hoofdmap en vervang het voorbeelddomein:
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 regelt de HTTPS-certificaten. Gebruik voor publiek hosten de releaseconfiguratie van Compose. Volg de volledige self-hostinghandleiding voor netwerken, e-mail, opslagconfiguratie en hostvereisten voor mediaverwerking.
Upload een kleine video in het dashboard, wacht op de verwerking en controleer de weergave. Kopieer de gegenereerde embed naar een aparte pagina en speel de video daar af. Open Data in het dashboard en geef analytics een paar seconden om te verschijnen.
Analytics gebruiken ClickHouse en ontvangen gebundelde HTTP-events op /v1/events. Gebruik de embed die je eigen installatie genereert. Bekijk voor eigen integraties de metricsconfiguratie.
Voer docker compose up -d uit vanuit de hoofdmap om op de achtergrond te starten. Met docker compose stop stop je de services met behoud van gegevens. Gegevens en gegenereerde secrets staan in persistente Docker-volumes. Maak van beide een back-up, samen met je .env als je die gebruikt. docker compose down -v verwijdert de volumes van je installatie.
Maak vóór een upgrade een back-up van databases en media en bewaar de vorige configuratie en image. Volg de upgrade-instructies voor jouw installatiemethode. Bestaande installaties via het installatiescript moeten hun huidige map, projectnaam, volumes en startmethode behouden. De bundel biedt geen automatische back-ups, hoge beschikbaarheid of migraties zonder downtime.
Stel installatievragen in de Discord-community. Meld bugs bij Mave Core op GitHub.
