Skip to main content

Hosting & Running Lavalink Servers

This guide details how to deploy and configure a dedicated Lavalink audio standalone node on your CordenX panel for Discord music bots (such as LavaLink-client, Erela.js, or DisTube).

1. Prerequisites & Java Requirement​

Lavalink requires Java 17 or Java 21 depending on the Lavalink version you run:

  • Lavalink v4: Requires Java 17+ (Java 21 recommended)
  • Lavalink v3: Requires Java 13 - Java 17

2. Setting Up Your Files​

  1. Download the latest Lavalink.jar release file from the official GitHub repository.
  2. In your CordenX panel, select your Lavalink server instance.
  3. Open File Manager and upload Lavalink.jar.
  4. Create a new file in File Manager named application.yml.

3. Configuring application.yml​

Paste the following base configuration into application.yml: yaml server: port: 2333 address: 0.0.0.0

lavalink: plugins:

Add plugins here if required (e.g. youtube-plugin)

server: password: "YOUR_SECURE_PASSWORD_HERE" sources: youtube: true bandcamp: true soundcloud: true twitch: true vimeo: true http: false local: false filters: # Enables audio filters (equalizer, timescale, volume, etc.) volume: true equalizer: true karaoke: true timescale: true tremolo: true vibrato: true distortion: true rotation: true channelMix: true lowPass: true bufferDurationMs: 400 frameBufferDurationMs: 5000 opusEncodingQuality: 10 resamplingQuality: HIGH trackStuckThresholdMs: 10000 useSeekGhosting: true youtubePlaylistLoadLimit: 6 playerUpdateInterval: 5

metrics: prometheus: enabled: false endpoint: /prometheus

logging: file: path: ./logs/Lavalink.log

level: root: INFO lavalink: INFO

Important: Change YOUR_SECURE_PASSWORD_HERE to a strong custom password and ensure the server.port matches your assigned primary network allocation port.

4. Port Allocations & Connecting Your Bot​

  1. Go to the Network tab in your panel sidebar to verify your primary server port (e.g., 2333 or a custom port like 10542).
  2. Ensure server.port in application.yml matches this primary port.
  3. In your Discord bot's connection script, connect using:
    • Host: Node IP or hostname (e.g., node1.cordenx.xyz)
    • Port: Your assigned primary port
    • Password: The password set in application.yml

5. Starting the Node​

  1. Navigate to Console.
  2. Click Start.
  3. Watch the console logs for confirmation: Lavalink is ready to accept connections.