Set up Lavalink for music bots

Run Lavalink as its own server on Victus and connect your music bot to it: configure application.yml, use the Network tab address/port, and wire up a v4 client like lavalink-client, Shoukaku or Wavelink.

Lavalink is a standalone Java audio server that does the heavy lifting for music bots — it fetches, decodes and streams audio to Discord voice so your bot process stays light. On Victus you run Lavalink as its own server (a Java egg) and point your bot at it over the network, using the host and port shown on the Lavalink server's Network tab. Victus supports Java bot/Lavalink hosting specifically for this.

Step 1 — Create the Lavalink server

1. Order a Java-capable bot plan (Lavalink needs RAM of its own — 1GB+ is a sensible minimum) and open it in the panel.
2. Put the Lavalink v4 jar in the server root via the Files tab (or use a Lavalink egg that downloads it for you).
3. In the Startup tab, make sure it launches with java -jar Lavalink.jar on a Java 17+ image (Lavalink v4 requires Java 17 or newer).

Step 2 — Configure application.yml

server:
  address: 0.0.0.0
  port: 2333            # use the port from your server's Network tab
lavalink:
  server:
    password: "change-this-to-a-strong-password"
    sources:
      youtube: false    # v4 needs the youtube-source plugin instead
  plugins:
    - dependency: "dev.lavalink.youtube:youtube-plugin:1.18.2"
      repository: "https://maven.lavalink.dev/releases"

Step 3 — Connect your bot

// Node.js example (Shoukaku / lavalink-client style config)
const nodes = [{
  name: 'main',
  url: 'YOUR_LAVALINK_HOST:2333',            // from the Network tab
  auth: 'change-this-to-a-strong-password', // must match application.yml
  secure: false,
}];

# Python example (Wavelink 3.x)
import wavelink
node = wavelink.Node(
    uri="http://YOUR_LAVALINK_HOST:2333",         # from the Network tab
    password="change-this-to-a-strong-password",  # must match application.yml
)