Lavalink

Lavalink

Docker app from ChongZhiJie's Repository

Overview

Source: https://github.com/freyacodes/Lavalink Before you Deploy please create folder Names "Lavalink" /mnt/user/appdata/Lavalink/application.yml and upload application.yml to folder

Readme

View on GitHub

Lavalink

Lavalink logo

A standalone audio sending node based on Lavaplayer and Koe. Allows for sending audio without it ever reaching any of your shards.

Being used in production by FredBoat, Dyno, LewdBot, and more.

A basic example bot is available.

Lavalink Guild

[!NOTE] Lavalink v4 is now out of beta! See the changelog for more information.

Getting started

Table of Contents

Features

  • Support for DAVE
  • Powered by Lavaplayer
  • Minimal CPU/memory footprint
  • Twitch/YouTube (via this plugin) stream support
  • Event system
  • Seeking
  • Volume control
  • REST API for resolving Lavaplayer tracks, controlling players, and more
  • Statistics (good for load balancing)
  • Basic authentication
  • Prometheus metrics
  • Docker images
  • Plugin support

Requirements

  • Java 17 LTS or newer required. (we recommend running the latest LTS version or newer)
  • OpenJDK or Zulu running on Linux AMD64 is officially supported.

Support for other JVMs is also best-effort. Periodic CPU utilization stats are prone not to work everywhere.

Hardware Support

Lavalink also runs on other hardware, but support is best-effort. Here is a list of known working hardware:

Operating System Architecture DAVE Lavaplayer JDA-NAS Timescale AVX2
linux x86-64 ✅ ✅ ✅ ✅ ✅
linux x86 ✅ ✅ ✅ ✅ ✅
linux arm ✅ ✅ ✅ ✅ ❌
linux armhf ✅ ✅ ❌ ❌ ❌
linux aarch32 ✅ ✅ ❌ ❌ ❌
linux aarch64 ✅ ✅ ✅ ✅ ❌
linux-musl x86-64 ✅ ✅ ✅ ✅ ✅
linux-musl aarch64 ✅ ✅ ✅ ✅ ❌
windows x86-64 ✅ ✅ ✅ ✅ ✅
Windows x86 ✅ ✅ ✅ ✅ ✅
Windows aarch64 ✅ ❌[^1] ✅ ❌[^1] ❌[^1]
darwin x86-64 ✅ ✅ ✅ ✅ ✅
darwin aarch64e ✅ ✅ ✅ ✅ ❌

[^1]: Windows on ARM is not natively supported, but seems to work fine with x86-64 JVMs & emulation.

[!NOTE] The minium supported version for glibc in DAVE is 2.35 (Ubuntu 22.04).

Changelog

Please see here

Versioning policy

Lavalink follows Semantic Versioning.

The version number is composed of the following parts:

MAJOR breaking API changes
MINOR new backwards compatible features
PATCH backwards compatible bug fixes
PRERELEASE pre-release version
BUILD additional build metadata

Version numbers can come in different combinations, depending on the release type:

`MAJOR.MINOR.PATCH` - Stable release
`MAJOR.MINOR.PATCH+BUILD` - Stable release with additional build metadata
`MAJOR.MINOR.PATCH-PRERELEASE` - Pre-release
`MAJOR.MINOR.PATCH-PRERELEASE+BUILD` - Pre-release additional build metadata

Install Lavalink on Unraid in a few clicks.

Find Lavalink in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Lavalink Review the template variables and paths Click Install
Explore Unraid OS

Categories

Media Server > Music

Download Statistics

13,469,695
Total Downloads
3,238
This Month
4,716
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all
Music apps

Links

Projectgithub.comDocker Hubhub.docker.comTemplateraw.githubusercontent.com

Details

Repository
fredboat/lavalink:latest
Registry
https://hub.docker.com/r/fredboat/lavalink
Last Updated2026-03-23
First Seen2023-04-20

Runtime arguments

Network
bridge
Shell
sh
Privileged
false

Template configuration

PortPorttcp
Target
2333
Default
2333
Value
2333
JAVA_HOMEVariable
Default
/opt/java/openjdk
Value
/opt/java/openjdk
LANGVariable
Default
en_US.UTF-8
Value
en_US.UTF-8
LANGUAGEVariable
Default
en_US:en
Value
en_US:en
LC_ALLVariable
Default
en_US.UTF-8
Value
en_US.UTF-8
JAVA_VERSIONVariable
Default
jdk-18.0.2.1+1
Value
jdk-18.0.2.1+1
Appication.ymlPathrw

Example:https://github.com/freyacodes/Lavalink/blob/master/LavalinkServer/application.yml.example

Target
/opt/Lavalink/application.yml