Een Lavalink-server hosten

Wat Lavalink nodig heeft

• Java 17 of nieuwer. Lavalink raadt de nieuwste LTS-versie aan.
• Lavalink 4.2 of nieuwer. Sinds maart 2026 staat Discord alleen nog end-to-end versleutelde spraak toe (het DAVE-protocol), en Lavalink 4.2.0 was de eerste versie die dat ondersteunt. Oudere servers kunnen in Discord geen audio meer afspelen.
• Een clientbibliotheek in je bot die dezelfde versie ondersteunt — de huidige lavalink-client, Shoukaku, Wavelink, lavalink.py en andere doen dat. Hoe je er een kiest, lees je in een Discord-muziekbot maken.
• Een machine die aan blijft, want de muziek stopt zodra Lavalink stopt.

Lavalink downloaden en starten

1. Download Lavalink.jar van de nieuwste release op GitHub naar een lege map.
2. Maak application.yml aan in dezelfde map (volgende sectie).
3. Start het vanuit die map:

java -jar Lavalink.jar

Lavalink is klaar zodra de log laat zien dat het is gestart. Op een Linux-server raadt de Lavalink-documentatie aan het als systemd-service te draaien, zodat het herstart na een crash en na een reboot; er is ook een Docker-image beschikbaar.

application.yml configureren

Een minimale Lavalink 4-configuratie met de YouTube-plugin:

server:
  port: 2333
  address: 0.0.0.0
lavalink:
  plugins:
    - dependency: "dev.lavalink.youtube:youtube-plugin:1.18.2"
      snapshot: false
  server:
    password: "a-long-random-password"
    sources:
      youtube: false
      soundcloud: true
      bandcamp: true
      twitch: true
      vimeo: true
      http: true
      local: false
plugins:
  youtube:
    enabled: true
    allowSearch: true

• password — wijzig dit. De voorbeeldconfiguratie gebruikt youshallnotpass, en dat is openbaar; iedereen die je server vindt, kan hem met het standaardwachtwoord gebruiken.
• port — standaard 2333; je bot maakt verbinding met deze poort.
• sources.youtube: false — de ingebouwde YouTube-bron is verouderd. De plugin vervangt hem, en volgens de documentatie van de plugin moet de ingebouwde bron uit staan.
• http: true laat de bot directe links afspelen; het officiële voorbeeld waarschuwt dat dit zonder proxy het IP van je server kan prijsgeven.

YouTube, Spotify en andere bronnen

Plugins staan onder lavalink.plugins en worden bij het opstarten gedownload. Twee zijn het kennen waard:

• youtube-source (dev.lavalink.youtube:youtube-plugin) — afspelen en zoeken op YouTube. YouTube blokkeert geautomatiseerde toegang actief, dus het kan stoppen met werken totdat de plugin is bijgewerkt; houd hem op de nieuwste versie.
• LavaSrc (com.github.topi314.lavasrc:lavasrc-plugin) — voegt Spotify, Apple Music, Deezer en meer toe. Van Spotify- en Apple Music-links worden de nummergegevens gelezen, en de audio wordt vanuit een andere bron afgespeeld.

Je bot met Lavalink verbinden

Elke Lavalink-client vraagt om dezelfde vier waarden, samen een node genoemd:

Wavelink in Python gebruikt bijvoorbeeld wavelink.Node(uri="http://your-host:2333", password="..."). Kan de bot geen verbinding maken, controleer dan eerst het wachtwoord en daarna of de poort bereikbaar is vanaf de plek waar de bot draait.

Lavalink-hosting bij HytHost

1. Kies Lavalink als runtime. Kies bij Discord-bothosting een pakket en selecteer Lavalink als taal. De server installeert de nieuwste Lavalink op Java 21 met de officiële voorbeeldconfiguratie.
2. Wijzig het wachtwoord. Open application.yml in de bestandsbeheerder en vervang het standaardwachtwoord. Het paneel zet het adres en de poort al op de eigen poort van je server, dus laat die twee zoals ze zijn.
3. Voeg de YouTube-plugin toe als je YouTube wilt: het pluginblok en youtube: false uit de configuratie hierboven, en herstart daarna.
4. Verbind je bot met het serveradres en de poort uit je paneel en het wachtwoord dat je hebt ingesteld.

Lavalink draait als eigen server, los van je bot. Bestel één pakket voor de bot en één met de Lavalink-runtime, of vraag ons bij een pakket met meerdere botslots er één naar de Lavalink-runtime om te zetten. In onze tests gebruikt Lavalink in rust minder dan 200 MB; voor één kleine bot is ons advies 1 GB, meer als hij in veel servers tegelijk speelt.