Zelf muziek streamen vanaf een eigen VPS
Bouw uw eigen muziekserver met Navidrome op een VPS. Leer hoe u opslag beheert, de Subsonic API gebruikt, TLS configureert en uw muziekcollectie veilig offline synchroniseert.
Wat zelfgehoste muziekstreaming op een VPS u oplevert
Zelfgehoste muziekstreaming op een VPS betekent dat u de speler beheert en zelf de muziek aanlevert. De server bevat bestanden die u reeds bezit en elke telefoon kan deze via internet bereiken met een normale login. Wees eerlijk over de afweging voordat u begint: dit vervangt de speler van een streamingdienst, niet de catalogus. Er verschijnt niets nieuws in uw bibliotheek totdat u het koopt of ript en het bestand naar de server kopieert.
Audio is veel minder belastend voor een server dan video. De bestanden zijn klein, telefoons decoderen elk gangbaar formaat zonder hulp en één luisteraar verbruikt minder bandbreedte dan een videogesprek. CPU is hier het eenvoudige onderdeel. Schijfruimte is de werkelijke beperkende factor. De andere twee zaken die bepalen of dit werkt, zijn de kwaliteit van uw tags en of uw telefoon-app muziek kan downloaden voor offline gebruik.
Welke muziekserver: Navidrome, Jellyfin of Funkwhale?
Navidrome is de standaardkeuze wanneer u alleen audio nodig heeft. Het is één Go-binary in één container en het houdt de status bij in één SQLite-database. Het ondersteunt de Subsonic API, wat de reden is dat er een groot aantal externe telefoon-apps bestaat. Versie 0.64.2, uitgebracht op 24 september 2026, was de huidige release op 27 oktober 2026. Gebruik geen versies ouder dan 0.64.1, waarin vijf beveiligingslekken werden gedicht, waaronder onbeperkt wachtwoord raden tegen de Subsonic-login. Het project beschrijft dat het goed draait op hardware met beperkte middelen zoals een Raspberry Pi, dus de serversoftware is niet het onderdeel waarvoor u betaalt.
Jellyfin is het overwegen waard als u al Jellyfin als mediaserver op een VPS draait voor video. De muziekbibliotheek werkt goed en Finamp is een gratis Jellyfin-muziek-app voor Android en iOS die nummers downloadt voor offline luisteren. Jellyfin zelf heeft nog steeds geen ingebouwd Subsonic-eindpunt, maar een community-plugin voegt dit toe. Subfin-NG, een fork van de Subfin-plugin, "laat Subsonic-compatibele muziek-apps uw Jellyfin-muziekbibliotheek afspelen" door een OpenSubsonic API aan Jellyfin toe te voegen. Dit vereist Jellyfin 12.0 of hoger, een ondergrens die release v12.1.13.0 op 16 oktober 2026 instelde toen ondersteuning voor Jellyfin 12.0 werd toegevoegd. Het verandert ook snel: tussen 24 en 28 september 2026 verschenen er minstens zeven releases. Subsonic-apps kunnen Jellyfin dus ook bereiken via een externe plugin in plaats van een kernfunctie, en het is verstandig om uw gekozen client hierop te testen voordat u erop vertrouwt. De brug werkt ook andersom: Navidrome 0.64.0 voegde een experimentele Jellyfin API toe, standaard uitgeschakeld en in te schakelen met ND_JELLYFIN_ENABLED, waarvan de documentatie stelt dat deze is getest met Finamp, Jellify en Feishin.
Funkwhale is de gefedereerde optie en versie 2.0 werd uitgebracht in maart 2026. Een Funkwhale-server wordt een pod genoemd, pods federeren via ActivityPub (het protocol achter Mastodon) en gebruikers volgen elkaars afspeellijsten over pods heen. Versie 2.0 verving de oude bibliotheken door afspeellijsten, waardoor bibliotheek-volgers afspeellijst-volgers werden, en een 2.0-pod federeert niet met pods die nog op 1.x draaien. Het ondersteunt ook een deel van de Subsonic API, met één belangrijk verschil: elke gebruiker stelt een apart Subsonic-wachtwoord in in de eigen instellingen, omdat het Subsonic-protocol een wachtwoord verwacht dat de server kan uitlezen. Funkwhale is een zwaardere installatie, omdat het naast de web-app ook PostgreSQL en een takenwachtrij nodig heeft.
Kies Navidrome tenzij u federatie wilt of tenzij Jellyfin al draait. De rest van deze handleiding configureert Navidrome met Docker.
Waarom de Subsonic API bepaalt welke telefoon-app u gebruikt
Subsonic was een muziekserver waarvan de HTTP API de gemeenschappelijke taal werd voor zelfgehoste audio, en OpenSubsonic is het communityproject dat deze API blijft uitbreiden. Die geschiedenis is de reden waarom u op uw telefoon keuzemogelijkheden heeft. Navidrome levert zelf geen mobiele app en heeft die ook niet nodig, omdat elke Subsonic-client inlogt met een serveradres en uw accountgegevens.
Dit is vooral van belang voor offline synchronisatie, de functie die bepaalt of de opstelling geschikt is voor dagelijks gebruik. Een telefoon in een tunnel kan uw server niet bereiken, dus moet de client de bestanden vooraf naar de lokale opslag hebben gekopieerd. Elke client streamt. Slechts enkele downloaden. De client-directory op navidrome.org/apps geeft aan welke dit doen, en de keuze is ruim op beide platforms: Substreamer en Ultrasonic op Android, Amperfy en play:Sub op iOS. Verschillende van de krachtigste clients zijn betaalde apps, en Symfonium op Android is degene die mensen het vaakst noemen. Installeer er twee voordat u een beslissing neemt, want dit is het onderdeel van het systeem dat u dagelijks gebruikt.
Hoeveel opslagruimte heeft een muziekbibliotheek nodig?
De gegevens achter deze grafiek
[
{
"label": "Opus 128k",
"kbps": 128,
"gb_per_1000_albums": 43
},
{
"label": "MP3 320k",
"kbps": 320,
"gb_per_1000_albums": 108
},
{
"label": "FLAC 16/44.1",
"kbps": 900,
"gb_per_1000_albums": 304
},
{
"label": "FLAC 24/96",
"kbps": "3,000",
"gb_per_1000_albums": "1,013"
}
]Dit zijn schattingen op basis van de bitrate, geen metingen van een daadwerkelijke collectie. De berekening is eenvoudig genoeg om te controleren aan de hand van uw eigen bestanden. Reken voor een album met 45 minuten, wat neerkomt op 2.700 seconden. Vermenigvuldig de bitrate in kilobits per seconde met 2.700 en deel het resultaat door 8.000 om het aantal megabytes te verkrijgen. Bij 320 kbps geeft dit 108 MB voor één album; duizend albums nemen dus ongeveer 108 GB in beslag.
Bij lossless-bestanden verandert het antwoord. FLAC van cd-kwaliteit haalt gemiddeld bijna 900 kbps bij standaardmateriaal, waardoor diezelfde duizend albums ongeveer 304 GB vereisen. Een bibliotheek met 24-bit, 96 kHz-bestanden loopt op tot ongeveer 1,013 GB, oftewel een volledige terabyte voor een collectie die u op papier zou kunnen noteren. Een voor telefoons geschikte Opus-kopie op 128 kbps past diezelfde duizend albums in 43 GB. Voer du -sh /path/to/music uit op de bibliotheek die u al bezit, aangezien uw eigen gemiddelde bitrate het enige getal is dat ertoe doet bij het kiezen van een abonnement.
Bandbreedte is het kleinste deel van de kosten. Een stream van 320 kbps verbruikt 40 kilobytes per seconde, dus een uur luisteren verplaatst ongeveer 144 MB. Honderd uur per maand komt neer op ongeveer 14 GB, wat binnen de datalimiet van elke VPS valt. De uitzondering is de eerste offline synchronisatie van een telefoon, die op één avond tientallen gigabytes kan verbruiken.
Storage-tier of compute-tier?
Een muziekserver is een grote verzameling 'cold data' waarbij nauwelijks rekenkracht nodig is. Het lezen van een bestand met 40 kilobytes per seconde belast een schijf nauwelijks, en de CPU heeft alleen werk tijdens een bibliotheekscan, tijdens transcoding (wat u meestal niet zult doen), en bij het extraheren en cachen van albumhoezen tijdens een scan of wanneer een item voor het eerst wordt geopend. De snelle NVMe-schijf van een compute-plan biedt hier dus geen voordeel, terwijl de prijs per gigabyte u juist belemmert om uw FLAC-bestanden te uploaden. Dit is een situatie waarin een storage-VPS beter is dan een reguliere VPS, omdat deze abonnementen geprijsd zijn per terabyte in plaats van per core.
Het geheugenverbruik is bescheiden. Navidrome draait een persoonlijke bibliotheek met enkele honderden megabytes, waarbij de scan het piekverbruik veroorzaakt in plaats van het afspelen. Geef de server 1 GB of 2 GB RAM en besteed de rest van het budget aan schijfruimte.
Navidrome installeren met Docker Compose
Maak eerst de mappen aan, met als eigenaar de user-id waaronder de container zal draaien. Als Compose nieuw voor u is, behandelt Docker Compose op een VPS de aannames van dit bestand.
sudo install -d -m 755 -o 1000 -g 1000 /srv/navidrome /srv/musicSchrijf docker-compose.yml in een eigen map, zonder verdere toevoegingen:
services:
navidrome:
image: deluan/navidrome:0.64.2
user: "1000:1000"
ports:
- "127.0.0.1:4533:4533"
restart: unless-stopped
environment:
ND_LOGLEVEL: "info"
ND_SESSIONTIMEOUT: "24h"
ND_SCANNER_SCHEDULE: "@every 24h"
ND_BACKUP_PATH: "/data/backup"
ND_BACKUP_SCHEDULE: "0 4 * * *"
ND_BACKUP_COUNT: "7"
volumes:
- /srv/navidrome:/data
- /srv/music:/music:rodocker compose up -d
docker compose psdocker compose ps hoort de service als actief te tonen in plaats van als herstartend. Een container die in een lus blijft herstarten, heeft bijna altijd een probleem met de rechten op /srv/navidrome, en docker compose logs navidrome benoemt het bestand waarnaar niet geschreven kon worden.
Vier details in dat bestand zijn een toelichting waard. De poort wordt alleen op 127.0.0.1 gepubliceerd, zodat de server bereikbaar is via de reverse proxy en niet op poort 4533 vanaf het open internet: Docker schrijft zijn eigen firewallregels, waardoor een simpele 4533:4533 alsnog blootgesteld blijft, zelfs op een systeem waar ufw alles als geweigerd rapporteert. Het muziekvolume is alleen-lezen, wat betekent dat een bug in de scanner uw enige kopie niet kan verwijderen. ND_SCANNER_SCHEDULE is standaard uitgeschakeld, en handleidingen geschreven vóór Navidrome 0.55 noemen het ND_SCANSCHEDULE, de oude naam die in 0.55 is gewijzigd. De drie back-upinstellingen activeren de ingebouwde database-back-up waar de back-upsectie hieronder op vertrouwt.
Zet uw muziek op de server
Kopieer de bibliotheek met rsync; dit hervat de overdracht in plaats van opnieuw te beginnen wanneer de verbinding wegvalt.
rsync -av --info=progress2 ~/Music/ user@music.example.com:/srv/music/De afsluitende slash bij de bron is van belang. Zonder deze slash krijgt u /srv/music/Music. Wanneer het kopiëren is voltooid, corrigeert u het eigenaarschap:
sudo chown -R 1000:1000 /srv/music
id -uDe container draait onder gebruikers-ID 1000 en de mount is alleen-lezen, dus dat ID heeft leesrechten voor elk bestand en toegang tot elke map nodig. Als de kopie wordt geplaatst met een andere eigenaar en rechten die anderen de toegang ontzeggen, vindt de scan nul nummers terwijl de webinterface leeg blijft, en toont het logboek open /music: permission denied. De bovenstaande chown is één oplossing. Als andere programma's de map ook gebruiken, suggereert de Docker-documentatie van Navidrome om de map open te stellen voor lezen, zonder de eigenaar te wijzigen: sudo chmod -R a+rX /srv/music. id -u toont uw werkelijke ID, en hoe PUID en PGID werken in Docker-containers legt de mapping volledig uit.
Een reverse proxy en TLS zodat de telefoon overal werkt
Wijs een DNS A-record naar de VPS en geef Caddy vervolgens drie regels:
music.example.com {
reverse_proxy 127.0.0.1:4533
}sudo systemctl reload caddyCaddy vraagt het certificaat op de achtergrond aan zodra de site wordt geladen, zonder op een bezoeker te wachten. Poort 443 moet openstaan. Caddy schakelt standaard twee ACME-challenges (automatic certificate management environment) in: de HTTP-challenge op poort 80 en de TLS-ALPN-challenge op poort 443. Het kiest er willekeurig een in plaats van altijd met HTTP te beginnen. Na een mislukking probeert het één keer opnieuw en schakelt dan over naar de andere challenge, dus een gesloten poort 80 stopt het certificaat niet. Laat poort 80 desondanks open, omdat Caddy's automatische redirect van HTTP naar HTTPS daar wordt afgehandeld. Voeg op nginx proxy_buffering off; toe aan het location-blok: Navidrome pusht voortgangsgebeurtenissen naar de webinterface via één langdurige verbinding, en met buffering ingeschakeld blijft de interface wachten op een antwoord dat nginx nog vasthoudt. Als u het serveert onder een pad zoals /music in plaats van een eigen subdomein, stel dan ND_BASEURL in op hetzelfde pad, anders laadt de interface als een lege pagina. De drie gangbare proxies worden vergeleken in Nginx, Caddy en Traefik op een VPS.
Open de site en maak het eerste account aan. Er is geen standaardwachtwoord en de eerste bezoeker wordt gevraagd de beheerder aan te maken, dus doe dit voordat u het adres aan anderen geeft. Test vervolgens het exacte pad dat een telefoon-client gebruikt:
SALT=$(openssl rand -hex 6)
TOKEN=$(printf '%s%s' 'YOUR_PASSWORD' "$SALT" | md5sum | cut -d' ' -f1)
curl -s "https://music.example.com/rest/ping.view?u=YOUR_USER&t=$TOKEN&s=$SALT&v=1.16.1&c=curl&f=json"Een gezond antwoord begint met {"subsonic-response":{"status":"ok" en noemt navidrome als servertype. Een body met "status":"failed" en foutcode 40 betekent dat de proxy in orde is en de inloggegevens onjuist zijn. Een certificaatfout bij deze stap moet als eerste worden opgelost, omdat de meeste telefoon-clients een ongeldig certificaat afwijzen met een bericht dat de gebruiker niets vertelt.
Waarom uw bibliotheek er na de eerste scan onjuist uitziet
Navidrome bladert op basis van tags in plaats van mappen, dus de tags bepalen wat u ziet. Een nummer zonder 'album artist'-tag wordt onder de 'track artist' ingedeeld; dit is de reden waarom een verzamelalbum met voor elk nummer een andere artiest verandert in twintig albums met elk één nummer. Corrigeer dit in de bestanden zelf, niet in Navidrome: MusicBrainz Picard en beets zoeken beide een album op in de MusicBrainz-database en schrijven de standaard tags terug.
Navidrome splitst ook een 'multi artist'-tag in afzonderlijke artiesten, waardoor een bandnaam die een scheidingsteken bevat per ongeluk wordt gesplitst; AC/DC is het voorbeeld dat iedereen tegenkomt. ND_SCANNER_ARTISTSPLITEXCEPTIONS bevat de namen die nooit gesplitst mogen worden.
Nieuwe bestanden worden enkele seconden nadat ze zijn geplaatst opgepikt door een file watcher. De watcher is afhankelijk van kernel-wijzigingsmeldingen, en deze komen niet aan voor bestanden die zijn geschreven op een netwerkshare die vanaf een andere machine is gemount. Bij dat type configuratie is de periodieke ND_SCANNER_SCHEDULE daarom wat de bibliotheek actueel houdt. Een volledige rescan leest de tags van elk bestand, wat traag is bij een grote bibliotheek, en dat is een van de redenen waarom de onderliggende database het beschermen waard is.
Gebruikers, afspeellijsten en delen
Een beheerder maakt de overige accounts aan in de webinterface; zelfregistratie is niet mogelijk. Elke gebruiker krijgt afzonderlijke afspeeltellingen, afspeellijsten, favorieten en beoordelingen, zodat een huishouden niet één gezamenlijk smaakprofiel deelt.
Afspeellijsten komen op twee manieren tot stand. Een afspeellijst die in een client is gemaakt, wordt opgeslagen in de database. Een .m3u-bestand dat in de bibliotheekmap wordt geplaatst, wordt tijdens de scan geïmporteerd; dit is de eenvoudigste manier om afspeellijsten over te zetten vanaf een desktopspeler. Slimme afspeellijsten zijn .nsp-bestanden, kleine JSON-regelbestanden die op dezelfde wijze worden geïmporteerd en die zichzelf bijwerken naarmate de bibliotheek verandert.
Delen is standaard ingeschakeld vanaf versie 0.63.0, uitgebracht in juli 2026. Hiermee kan een gebruiker een openbare link naar een album maken die iedereen kan openen zonder in te loggen. Op een server die uw volledige bibliotheek bevat, is dit mogelijk niet gewenst; door ND_ENABLESHARING in te stellen op false wordt deze functie uitgeschakeld.
Maak een back-up van de database los van de muziekbestanden
De eigen back-upfunctie van Navidrome dekt alleen de database. De documentatie is hier duidelijk over: het back-upproces slaat de database op, inclusief gebruikers, afspeeltellingen en dergelijke, maar het slaat de muziek of de configuratie niet op. Deze scheiding is de juiste benadering, omdat beide onderdelen op verschillende manieren kunnen falen. Muziekbestanden kunnen opnieuw worden gekopieerd vanaf de schijf waarvan u ze hebt geript. Afspeeltellingen, beoordelingen, favorieten en afspeellijsten bestaan nergens anders en een nieuwe scan haalt deze niet terug.
Het compose-bestand schrijft al elke nacht een kopie naar /data/backup en bewaart er zeven. Maak handmatig een kopie voordat u een upgrade uitvoert:
sudo docker compose run --rm navidrome backup createDe overstap van 0.63 naar 0.64 is de upgrade waarbij dit het meest noodzakelijk is. Versie 0.64.0 codeert elke interne id opnieuw tijdens een migratie die elke tabel raakt, en clients die offline downloads bewaren moeten daarna mogelijk opnieuw synchroniseren.
Bij een herstelactie wordt de huidige database gewist en de back-up op die locatie teruggeplaatst; dit moet gebeuren terwijl Navidrome is gestopt. Een herstelactie is nooit veilig op een actieve server.
Deze bestanden staan nog steeds op dezelfde VPS, dus ze overleven het niet als de VPS uitvalt. Verplaats /srv/navidrome volgens een schema naar een andere machine of naar object storage; dit is de taak waarvoor restic en BorgBackup zijn ontworpen. De gehele map is klein, meestal ruim onder een gigabyte, dus een dagelijkse versleutelde kopie buiten de server kost vrijwel niets en herstelt alles wat een nieuwe scan niet kan terughalen.
FAQ
Moet ik muziek transcoderen op een VPS?
Bijna nooit. Telefoons decoderen MP3, AAC, Opus en FLAC zelf, net als moderne browsers op de meeste systemen. De server verstuurt het bestand zoals het is en verbruikt vrijwel geen CPU. Browsers zijn het punt van aandacht: Firefox speelt AAC alleen af als het besturingssysteem of een externe bibliotheek de decoder levert, waardoor een AAC-bibliotheek in een webspeler soms een getranscodeerde stream vereist. De situatie waarin dit het meest zinvol is, is een FLAC-bibliotheek die via mobiele data wordt gestreamd. Hierbij zorgt het converteren van ongeveer 900 kbps naar Opus op 128 kbps voor een vermindering van het dataverbruik met ongeveer een factor zeven. Navidrome beheert transcoding op de server sinds versie 0.61: het detecteert welke codecs een client ondersteunt, past bitrate-standaarden toe op basis van het formaat en stelt u in staat de bitrate per speler te beperken.
Waarom kan mijn telefoon-app geen muziek downloaden voor offline gebruik?
Omdat offline opslag een functie van de client is, niet van de server. De Subsonic API stelt elke client in staat om een volledig bestand op te halen, maar de app bepaalt of er een kopie op de telefoon wordt bewaard. Controleer de client-directory op navidrome.org/apps en kies een app waarvan de beschrijving offline downloads of caching vermeldt. Sommige clients cachen alleen wat u al heeft afgespeeld; dit is niet hetzelfde als het synchroniseren van een album voor een reis.
Waarom is één album na de scan opgesplitst in meerdere albums?
De tag voor de albumartiest ontbreekt of is inconsistent over de tracks heen. Navidrome groepeert op basis van tags in plaats van mappen. Twaalf tracks met twaalf verschillende artiestwaarden en geen gedeelde albumartiestwaarde zien eruit als twaalf albums. Stel de tag voor de albumartiest in op elke track van het album, meestal op Various Artists voor een verzamelalbum, en laat de scan opnieuw uitvoeren. MusicBrainz Picard of beets kunnen dit voor een hele map tegelijk doen.
Vervangt zelfgehoste muziekstreaming Spotify?
Het vervangt de speler en de bibliotheek, niet de catalogus. U krijgt uw eigen collectie op elk apparaat, met de afspeellijsten en afspeeltellers die geen licentiewijziging van u af kan nemen. U krijgt geen nieuwe releases en geen aanbevelingen op basis van het luistergedrag van anderen. De meeste mensen die dit draaien, kopen hun muziek en houden een goedkoop streaming-abonnement aan voor het ontdekken van nieuwe muziek.