Een Lavalink-server 24/7 hosten

Om een Lavalink-server 24/7 online te houden heb je vier dingen nodig: een machine die nooit slaapt, Java 17 of nieuwer, de Lavalink.jar uit de GitHub-releases van Lavalink met een application.yml die je eigen wachtwoord instelt, en iets dat Lavalink weer start na een crash of herstart. Je bot verbindt dan met het adres, de poort en het wachtwoord van de server. Voor YouTube heb je ook de YouTube-plugin nodig, ingelogd met een reserve-Google-account; de huidige versie heeft meer nodig dan dat, zie YouTube afspelen op Lavalink 4. Een Lavalink-pakket van PlayNHost heeft dat allemaal geïnstalleerd: Lavalink 4.2.2, de YouTube-plugin en een wachtwoord dat voor jouw node is gemaakt. In onze test op het pakket van 1 GB was hij 11 tot 13 seconden na de start klaar en gebruikte hij in rust ongeveer 240 MiB geheugen.

Wat een Lavalink-server nodig heeft om 24/7 te draaien

Draai hem op je eigen Linux-server

Dit zijn de stappen uit de eigen documentatie van Lavalink.

1. Installeer Java 17 of nieuwer en controleer het met java -version.
2. Maak een map, bijvoorbeeld /home/lavalink/lavalink, en zet daar Lavalink.jar in, gedownload van de nieuwste release op de GitHub van Lavalink. Op 6 november 2026 is dat 4.2.2.
3. Maak ernaast application.yml. De kleinste bruikbare stelt de poort, het adres en een eigen wachtwoord in en zet de oude ingebouwde YouTube-bron uit, die Lavalink niet meer bijwerkt:

server:
  port: 2333
  address: 0.0.0.0
lavalink:
  server:
    password: "change-this-to-a-long-random-password"
    sources:
      youtube: false
      soundcloud: true
      http: true

4. Start hem één keer met de hand met java -jar Lavalink.jar en wacht op Lavalink is ready to accept connections.
5. Om hem draaiende te houden, maak je er een systemd-service van. De documentatie van Lavalink geeft deze unit; sla hem op als /usr/lib/systemd/system/lavalink.service met je eigen gebruiker en map:

[Unit]
Description=Lavalink Service
After=syslog.target network.target

[Service]
User=lavalink
Group=lavalink
WorkingDirectory=/home/lavalink/lavalink
ExecStart=java -Xmx4G -jar /home/lavalink/lavalink/Lavalink.jar
Restart=on-failure
RestartSec=5s

[Install]
WantedBy=multi-user.target

6. Voer sudo systemctl daemon-reload, sudo systemctl enable lavalink en sudo systemctl start lavalink uit. sudo journalctl -u lavalink toont het log.
7. Stel -Xmx in op de machine: -Xmx4G laat de heap van Java tot 4 GB groeien, meer dan een kleine server heeft. Open de poort in je firewall en test dan zoals bij stap 2 hieronder.

Vanaf dan werk je Java, Lavalink en de plugins zelf bij en let je op crashes. Voor YouTube heb je de plugin nodig: YouTube afspelen op Lavalink 4.

Op een PlayNHost-pakket: wat de installatie inricht

• Lavalink 4.2.2, gedownload van de GitHub-release van Lavalink en gecontroleerd met een vaste checksum.
• De YouTube-bronplugin, versie 1.18.2 met PlayNHost-fixes, in de map plugins als youtube-plugin-1.18.2-playnhost1.jar.
• Een application.yml met een wachtwoord dat speciaal voor jouw node is gemaakt, en deze bronnen aan: Bandcamp, Twitch, Vimeo, Niconico en directe http-links. De eigen SoundCloud- en YouTube-bronnen van Lavalink staan uit. YouTube loopt via de plugin. Alle audiofilters (equalizer, timescale, karaoke en de rest) staan aan.

Bij een latere herinstallatie blijft je application.yml staan en print de console Kept your application.yml.

1. Vind het adres en wachtwoord

1. Open je server in het panel. Overzicht toont de Lavalink-kaart met Nodenaam, Adres en Wachtwoord.
2. Druk naast Adres op het kopieericoon. Het kopieert host:port.
3. Bij Wachtwoord staat Staat in application.yml. Druk op application.yml openen. Kopieer onder lavalink: en server: de waarde van password: zonder de aanhalingstekens.

Behandel het wachtwoord als een sleutel: iedereen met het adres en het wachtwoord kan je node gebruiken. Wil je het wijzigen, pas dan password: in hetzelfde bestand aan, sla op, herstart de node en werk je bot bij.

2. Start hem en controleer hem

1. Open Console (of druk op de kaart op Logs) en druk op Starten.
2. Lavalink is klaar als de console dit toont:

Lavalink is ready to accept connections.

3. Om vanaf je eigen computer te testen, vraag je de node met je wachtwoord om zijn versie:

curl -H "Authorization: YOUR_PASSWORD" http://HOST:PORT/version

Hij antwoordt 4.2.2 als het werkt. 403 betekent dat het wachtwoord fout is, 401 dat de header Authorization ontbreekt. Krijg je helemaal geen antwoord, dan is het adres fout of staat de node stil.

Verbind daarna je bot: Je Discord-bot verbinden met Lavalink. De node gebruikt gewoon http en ws, dus laat de optie voor beveiligd of SSL uit in je client. Je client moet een release zijn die Discords DAVE-spraakversleuteling ondersteunt; de verbindingsgids noemt de versies.

3. Eén keer inloggen bij YouTube

Bij de eerste start vraagt de console je de YouTube-plugin in te loggen bij een Google-account, met een regel zoals:

OAUTH INTEGRATION: To give youtube-source access to your account, go to https://www.google.com/device and enter code XXXX-XXXX

Gebruik een reserve-Google-account dat je hiervoor hebt gemaakt, nooit je eigen: de makers van de plugin waarschuwen dat het account kan worden beëindigd. In onze test op 6 november 2026 (een starttest van 15 seconden per nummer, zonder spraakkanaal) kon de node vóór het inloggen geen enkel van de 12 YouTube-nummers starten, en startte hij daarna elk van de 10 voltooide tests zonder fout. Of YouTube een bepaald nummer aan een server geeft, beslist YouTube, en dat kunnen we niet beloven. De stappen, en hoe je het inloggen na een herstart behoudt: YouTube afspelen op Lavalink 4.

Wat het panel bij elke start herschrijft

Twee waarden in application.yml worden bij elke start van de node door het panel ingesteld. Wijzigingen daarin worden teruggezet:

• server.port: de poort van je server, de enige die naar internet openstaat. De 2333 die bij de installatie is geschreven, wordt vervangen.
• plugins.youtube.remoteCipher.url: een PlayNHost-dienst die de YouTube-plugin gebruikt en die alleen vanaf onze servers bereikbaar is.

Versie

Het tabblad Instellingen, Game-instellingen, heeft een veld Versie dat op 4.2.2 staat, de versie die we testen en ondersteunen. Op 6 november 2026 is dat ook de nieuwste release van Lavalink. Andere versies worden zonder checksum gedownload en worden niet ondersteund. De waarde wordt alleen gelezen terwijl de server wordt geïnstalleerd, dus hij geldt zodra je opnieuw installeert.

Opnieuw installeren

Een herinstallatie downloadt Lavalink en zijn plugins opnieuw. Dat repareert ook een beschadigde of verwijderde Lavalink.jar of pluginbestand. Je application.yml, met zijn wachtwoord en je wijzigingen, blijft staan.

1. Open het tabblad Instellingen en klik op Startdetails.
2. Zoek de kaart Opnieuw installeren ("Downloadt Lavalink en de plugins ervan opnieuw, in de versies die PlayNHost heeft getest. Je application.yml blijft."), druk op de knop Opnieuw installeren.
3. Bevestig in Deze server opnieuw installeren? door op Opnieuw installeren te drukken. De node stopt zolang de installatie loopt.
4. Druk als het klaar is op Console op Starten.

Plugins die je zelf hebt geüpload, blijven in de map plugins staan. De installatie vervangt alleen het YouTube-pluginbestand dat wij meeleveren.

Hoeveel geheugen een Lavalink-node gebruikt

De Java-heap van Lavalink is op onze pakketten beperkt tot driekwart van de geheugenlimiet van de server. We hebben de geïnstalleerde node op 6 november 2026 drie of vier keer gestart op elk pakketformaat, met dezelfde geheugen- en CPU-limieten, hetzelfde image en hetzelfde startcommando als het panel, op een van onze drukke productienodes, en lazen zijn geheugen 60 seconden nadat hij klaar was, zonder verbonden bot:

Een node in rust gebruikte op elk pakket ongeveer evenveel geheugen, grofweg een kwart van het pakket van 1 GB. De grotere pakketten geven de heap ruimte om te groeien en startten met meer CPU sneller in onze test. Elke player die streamt komt daar nog bij. We hebben nog niet gemeten hoeveel players elk pakket aankan, dus we noemen daar geen getal voor. Let na een dag echt gebruik op de kaart Gebruik op Overzicht: De gebruiksgrafieken van je server lezen.

Heb je een eigen Lavalink-node nodig?

Een gratis publieke node is prima om te testen of voor een piepkleine privébot. Een bot waar mensen op rekenen, draait beter op een node die je zelf beheert, omdat je dan zijn plugins, bronnen en wachtwoord kiest.

Controleer voordat je op een publieke node rekent of zijn Lavalink-hoofdversie bij je client past: een client voor versie 3 werkt niet met een node van versie 4. Later overstappen naar je eigen node betekent drie waarden in je bot wijzigen: host, poort en wachtwoord. Pakketten: Lavalink-hosting.

Hierna

• Verbind je bot: Je Discord-bot verbinden met Lavalink.
• Speel YouTube af: YouTube afspelen op Lavalink 4.
• Voeg bronnen en functies toe: Plugins toevoegen aan Lavalink.
• Gaat er iets mis: Lavalink-fouten en wat ze betekenen.