Skip to content

kerit-cloud/lavalink-hosting

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 

Repository files navigation

lavalink-hosting

Self-host your own Lavalink server using Kerit Cloud. Easy setup, configurable, and reliable for music bots.


Kerit Cloud Lavalink Hosting

Self-Managed & Managed Options

This comprehensive guide will help you host your own Lavalink server using Kerit Cloud, covering both self-managed and managed solutions.

What You'll Learn

  • How to purchase and deploy a Kerit Cloud server
  • Configuring application.yml for Lavalink
  • Installing and managing plugins (YouTube, Spotify, Apple Music, etc.)
  • Using LavaSrc for advanced music sources
  • Running and monitoring your Lavalink instance
  • Connecting your Discord bot to Lavalink
  • Troubleshooting and optimization tips

What is Lavalink?

Lavalink is a high-performance, standalone audio streaming server designed for Discord music bots.
It offloads audio processing from your bot, improving performance, scalability, and reliability.

Key Features:

  • Efficient audio streaming and playback
  • REST API & WebSocket support
  • Plugin system for extensibility
  • Audio filters and effects
  • Multiple music source integrations

📚 Official Documentation


Hosting Types on Kerit Cloud

Kerit Cloud offers two Lavalink hosting options:

Managed Lavalink

  • Preconfigured & ready to use
  • No manual setup required
  • Instant deployment via Control Panel
  • 24/7 support & monitoring
  • Learn more

Self-Managed Lavalink

  • Full configuration and plugin control
  • Custom Lavalink builds supported
  • Ideal for advanced users

This guide focuses on Self-Managed Lavalink Hosting.


Requirements

Before you begin, ensure you have:

  • Java 17 or newer (required by Lavalink)
  • Lavalink server JAR file (pre-installed on Kerit Cloud)
  • Kerit Cloud server (self-managed plan)
  • Discord music bot

Kerit Cloud Self-Managed plans come with Lavalink pre-installed—no manual installation needed!

Recommended Server Resources:

Bot Size RAM
Small 1 GB
Medium 2 GB
Large 4 GB+

Step 1 — Create a Kerit Cloud Server

  1. Sign up for a Kerit Cloud account
  2. Join the Kerit Cloud Discord for support
  3. Go to the order portal
  4. Select Self-Managed Hosting and choose your preferred plan
  5. Complete payment (UPI, crypto, Binance, PayPal, etc.)

After deployment, you'll receive:

  • Server access credentials
  • File manager & SFTP access
  • Console for server management

Step 2 — Access Your Server & File Manager

Once your server is ready (you'll get an email confirmation), access it via the Kerit Cloud panel.

Your Lavalink directory should look like:

/lavalink
├── Lavalink.jar
├── application.yml

Step 3 — Configure Lavalink

Lavalink uses application.yml for configuration.

Basic Example:

server:
    port: 2333
    address: 0.0.0.0

lavalink:
    server:
        password: "youshallnotpass"
        sources:
            youtube: true
            soundcloud: true
            bandcamp: true
            twitch: true
            vimeo: true
            http: true
            local: false
        filters:
            volume: true
            equalizer: true
            karaoke: true
            timescale: true
            tremolo: true
            vibrato: true
            distortion: true
            rotation: true
            channelMix: true
            lowPass: true

Step 4 — Start Lavalink

Use the console controls (start/restart) in the Kerit Cloud panel.

If successful, logs will show:

Lavalink is ready to accept connections

Default Connection Details:

Host: ca.kerit.cloud
Port: 7323
Password: youshallnotpass

Step 5 — Connect Your Discord Bot

Configure your bot to connect to Lavalink:

host: ca.kerit.cloud
port: 7323
password: youshallnotpass
secure: false

Popular Lavalink Libraries:


Step 6 — Installing Lavalink Plugins

Lavalink supports plugins for extra features and sources.

Common Plugin Use Cases:

  • Spotify, Apple Music, Deezer support
  • Improved search (LavaSearch)
  • SponsorBlock, lyrics, DSP effects

Plugin Example (in application.yml):

lavalink:
    plugins:
        - dependency: "com.example.plugin:plugin-name:VERSION"
            repository: "https://maven.lavalink.dev/releases"

Popular Plugins:

  • YouTube Plugin
  • LavaSrc (Spotify, Apple Music, Deezer)
  • LavaSearch
  • SponsorBlock
  • LavaLyrics
  • LavaDSPX

See all supported plugins


Step 7 — Install YouTube Plugin

The YouTube plugin is recommended for reliable YouTube playback.

Add to application.yml:

lavalink:
    plugins:
        - dependency: "dev.lavalink.youtube:youtube-plugin:VERSION"
            repository: "https://maven.lavalink.dev/releases"

Step 8 — Install LavaSrc

LavaSrc adds support for:

  • Spotify
  • Apple Music
  • Deezer

Plugin configuration:

lavalink:
    plugins:
        - dependency: "com.github.topi314.lavasrc:lavasrc-plugin:VERSION"
            repository: "https://maven.lavalink.dev/releases"

Step 9 — Configure LavaSrc

After installing, configure your sources:

plugins:
    lavasrc:
        sources:
            spotify: true
            applemusic: true
            deezer: true
        spotify:
            clientId: "SPOTIFY_CLIENT_ID"
            clientSecret: "SPOTIFY_CLIENT_SECRET"
            countryCode: "US"

You need a Spotify Developer application and a premium account for credentials.


Step 10 — Install LavaSearch

LavaSearch improves search results.

Plugin configuration:

lavalink:
    plugins:
        - dependency: "com.github.topi314.lavasearch:lavasearch-plugin:VERSION"
            repository: "https://maven.lavalink.dev/releases"

Full Example Configuration

server:
    port: 2333
    address: 0.0.0.0

lavalink:
    server:
        password: "supersecurepassword"
    plugins:
        - dependency: "dev.lavalink.youtube:youtube-plugin:VERSION"
            repository: "https://maven.lavalink.dev/releases"
        - dependency: "com.github.topi314.lavasrc:lavasrc-plugin:VERSION"
            repository: "https://maven.lavalink.dev/releases"

plugins:
    lavasrc:
        sources:
            spotify: true
            applemusic: true
            deezer: true
        spotify:
            clientId: "SPOTIFY_CLIENT_ID"
            clientSecret: "SPOTIFY_CLIENT_SECRET"
            countryCode: "US"

Troubleshooting

Lavalink Not Starting?

  • Check Java version (java -version)
  • Validate YAML syntax (use YAML Lint)
  • Ensure plugin versions are compatible

Bot Cannot Connect?

  • Verify server address, port, and password
  • Check if SSL/secure is set correctly

Performance Tips

  • Use at least 2GB RAM for medium/large bots
  • Keep Lavalink updated
  • Avoid running multiple heavy nodes on the same server

Conclusion

Hosting your own Lavalink node gives you:

  • Better performance and reliability
  • Full control over configuration and plugins
  • Access to advanced features and sources

Kerit Cloud self-managed hosting makes deployment fast and flexible, while managed plans offer a hassle-free experience.


Resources

🔗 Useful Links

Contributing

We welcome contributions! If you have suggestions, improvements, or additional resources for this Lavalink hosting setup, please consider submitting a pull request.

How to Contribute

  1. Fork the repository.
  2. Create a new branch for your changes: git checkout -b feature/your-feature-name
  3. Make your changes or additions.
  4. Commit your changes with a clear message: git commit -m "Add description of your changes"
  5. Push your branch: git push origin feature/your-feature-name
  6. Open a pull request detailing what you added or improved.

Guidelines

  • Keep changes relevant to Lavalink hosting, configuration, or helpful resources.
  • Follow existing formatting for README and configuration files.
  • Ensure links and code snippets are correct and tested.
  • Be respectful and constructive in comments and suggestions.

Thank you for helping improve this project!

Note:
Hosting and managing your own Lavalink server requires time and technical knowledge. For a seamless experience—including custom plugins (Amazon, Gaana, etc.) and 20+ music sources—consider Kerit Cloud's managed plans.

Be cautious of hosts making unrealistic claims or offering suspiciously cheap custom plugins; these often result in poor service and reliability. ( mentally ass nuisance ass services )

Releases

No releases published

Packages

 
 
 

Contributors