Lavalink Hosting

Discord voice audio requires an external audio delivery node (Lavalink) to encode, buffer, and stream music into voice channels without placing excessive load on the main bot process.

The Lavalink Hosting add-on provides fully managed, high-performance Lavalink infrastructure maintained directly by Zero Development, eliminating the need to set up or maintain your own Java audio server.

Why Lavalink Hosting?

Running a self-hosted Lavalink instance requires:

• Dedicated Java 17+ or Java 21 runtime environments.
• Continuous memory allocation (1 to 2 GB dedicated RAM) for audio buffering.
• High-bandwidth networking with low latency to Discord voice servers.
• Ongoing maintenance for source plugins and API updates.

With the Lavalink Hosting add-on, Zero Development handles all node maintenance, routing, and uptime. Your Medusa instance connects automatically with zero configuration files to edit.

Option 1: Managed Lavalink Hosting (Recommended)

Step 1: Purchase the Add-on

Purchase the Music Hosting / Lavalink Hosting add-on on Medusa's resource page via builtbybit.com/medusa.

Step 2: Claim the Entitlement

1. Join the Zero Development Discord.
2. Navigate to the 「🤖」commands channel.
3. Run the /claim command and submit your BuiltByBit invoice details.
4. The Music Hosting entitlement is attached directly to your Medusa license key.

Step 3: Automated Connection

1. Restart your Medusa bot (node index.js).
2. On startup, Medusa validates your license key against the Zero Development licensing API.
3. Upon detecting the Music Hosting entitlement, Medusa automatically retrieves your dedicated Lavalink node credentials and establishes an encrypted WebSocket connection.
4. No hostnames, ports, or passwords need to be entered manually.

  [ 09-13-2026 ~ 12:00am ] [ INF ] Connecting to hosted Lavalink node...
  [ 09-13-2026 ~ 12:00am ] [ SUC ] Lavalink connection established!

Option 2: Connecting a Custom Lavalink Node

If you prefer to maintain your own node, or if you order a dedicated Lavalink service from our hosting partner Haven Development, you can connect your custom node through the dashboard:

1. Open your Medusa Web Dashboard.
2. Navigate to the Music configuration settings.
3. Enter your custom node credentials:
   • Host: Server IP or domain (e.g. lavalink.havendevelopment.net).
   • Port: Audio port (default 2333, or 443 for SSL).
   • Password: Node authentication password (e.g. youshallnotpass).
   • Secure (SSL): Toggle on if your node uses HTTPS or WSS.
4. Save the configuration. Medusa reconnects to your designated node immediately.