How to Host a Lavalink Server

Introduction

Lavalink is a standalone audio sending node for Discord bots. It allows you to stream high-quality music to Discord without consuming your bot’s resources.

Downloading Lavalink

Get Lavalink JAR

Download the latest Lavalink release from the official GitHub releases. Download the Lavalink.jar file.

Create Configuration File

Create an application.yml file with your Lavalink configuration.

Configuration File

Create an application.yml file:

application.yml

server:
  port: 80
  address: 0.0.0.0

lavalink:
  server:
    password: "your-secure-password-here"
    sources:
      youtube: true
      bandcamp: true
      soundcloud: true
      twitch: true
      vimeo: true
      http: true
      local: false
    bufferDurationMs: 400
    frameBufferDurationMs: 5000
    youtubePlaylistLoadLimit: 6
    playerUpdateInterval: 5
    youtubeSearchEnabled: true
    soundcloudSearchEnabled: true
    gc-warnings: true

logging:
  file:
    path: ./logs/
  level:
    root: INFO
    lavalink: INFO

Important: Set the port to 80 for Shard Cloud hosting.

Shard Cloud Configuration

Create a .shardcloud file:

.shardcloud

DISPLAY_NAME=Lavalink Server
DESCRIPTION=Lavalink Audio Server
MAIN=Lavalink.jar
MEMORY=1024
VERSION=recommended
SUBDOMAIN=my-lavalink

The SUBDOMAIN gives you a URL like my-lavalink.shardweb.app to connect your bot.

Deploying

Prepare Files

Create a folder with: - Lavalink.jar - application.yml - .shardcloud

Create ZIP Archive

Compress the folder into a .zip file.

Upload to Shard Cloud

Go to Shard Cloud Dashboard and upload your ZIP file.

Connecting Your Bot

When connecting to your Lavalink server from your Discord bot:

Host: my-lavalink.shardweb.app
Port: 443 (SSL/HTTPS)
Password: Your configured password
Secure: true

Example Connection (discord.js + Shoukaku)

const { Shoukaku, Connectors } = require("shoukaku");

const nodes = [
  {
    name: "main",
    url: "my-lavalink.shardweb.app:443",
    auth: "your-secure-password-here",
    secure: true,
  },
];

const shoukaku = new Shoukaku(new Connectors.DiscordJS(client), nodes);

Example Connection (discord.py + wavelink)

import wavelink

node = wavelink.Node(
    uri='https://my-lavalink.shardweb.app:443',
    password='your-secure-password-here'
)

Always use port 443 and secure: true when connecting to your Lavalink on Shard Cloud.

Additional Resources

Troubleshooting

Connection refused

Verify the password matches - Use port 443 with secure/SSL enabled - Check that your Lavalink server is running

Out of memory

Increase the MEMORY value in your .shardcloud config (minimum 512MB recommended).

No audio sources

Check your application.yml to ensure the required sources are enabled.

Introduction

Platform Features

Bot Platforms

API Frameworks

Website Frameworks

How to Host a Lavalink Server

Introduction

Downloading Lavalink

Configuration File

Shard Cloud Configuration

Deploying

Connecting Your Bot

Example Connection (discord.js + Shoukaku)

Example Connection (discord.py + wavelink)

Additional Resources

Troubleshooting

​Introduction

​Downloading Lavalink

​Configuration File

​Shard Cloud Configuration

​Deploying

​Connecting Your Bot

​Example Connection (discord.js + Shoukaku)

​Example Connection (discord.py + wavelink)

​Additional Resources

​Troubleshooting

Introduction

Downloading Lavalink

Configuration File

Shard Cloud Configuration

Deploying

Connecting Your Bot

Example Connection (discord.js + Shoukaku)

Example Connection (discord.py + wavelink)

Additional Resources

Troubleshooting