# Lavalink

Lavalink is a standalone audio sending node that lets Discord music bots stream audio without it passing through your bot's shards. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/509/lavalink

## Description

Lavalink is a standalone audio sending node that lets Discord music bots stream audio without it passing through your bot's shards. Built on Lavaplayer and Koe, it handles audio processing and playback so your bot can focus on command handling. Used in production by popular bots including FredBoat, Dyno, and LewdBot.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

73/100 (Good), based on 5 of 5 factors.
- Maintained: 76 (last commit 60 days ago)
- Popular: 66 (1,913 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 95 (512 MB minimum RAM, runs on ARM)
- Security check: 100 (no serious findings, CI, tests)

## Links

- GitHub: https://github.com/lavalink-devs/Lavalink
- Docker Hub: https://hub.docker.com/r/fredboat/lavalink
- Official website: https://lavalink.dev/
- Unraid: https://ca.unraid.net/apps/lavalink-1kov4f71n2iobz?q=Lavalink

## Common questions

### What settings must match between the bot's Lavalink client and the Lavalink server?

Set authorization to the same password used by the Lavalink server, and point host and port to where the server is running, often localhost:2333. If the password or reachable port is wrong, the bot cannot connect and music will not play.

### Why should a Discord.js bot forward raw events to Lavalink?

Add a raw event listener that calls sendRawData and set sendToShard so voice updates are sent back to Lavalink. This keeps the bot and audio server in sync; without it, playback can fail or stop.

### What debug setting is useful during the first Lavalink setup?

Enable debug events in advancedOptions and log them temporarily. This helps show connection problems or why tracks will not start, and the setting can be turned off later to keep logs quiet.

### Which configuration areas commonly cause Lavalink errors?

Common issues involve configuring the Java environment, application.yml, and the network. A troubleshooting guide covers these common errors and fixes.

---
Source: Our Local Host (https://ourlocalhost.com/app/509/lavalink), the self-hosted and open-source app directory.