Skip to content

Trouble Shooting

If Lavalink won't start, check the following:

  • Make sure you have Java 17 or higher installed. You can download it here.

  • Make sure you have downloaded the latest Lavalink.jar from GitHub.

  • Make sure you have configured Lavalink correctly. Check out the configuration page for more information.

  • If you're using Docker, make sure you have configured Docker correctly. Check out the Docker page for more information.

  • If you're using Systemd, make sure you have configured Systemd correctly. Check out the Systemd page for more information.

  • If you are using a firewall, make sure you have opened the port you configured Lavalink to use.

  • If you are using a reverse proxy, make sure you have configured it correctly. Nginx needs to be configured to pass the Upgrade header for WebSockets to work.

Configuring more detailed Logging

If you are having issues with Lavalink, you can enable more detailed logging by adding the following to your application.yml:

In general there are 6 log levels: TRACE, DEBUG, INFO, WARN, ERROR and OFF.

application.yml
logging:
  level:
    # Set this to DEBUG to enable more detailed logging. Please note that this will log probably spam your console.
    root: INFO
    # Set this to DEBUG to enable more detailed logging from Lavalink
    lavalink: DEBUG
    # Set this to TRACE to see all WebSocket messages
    lavalink.server.io.SocketContext: TRACE
    # Log all track exceptions (COMMON, SUSPICIOUS & FAULT)
    com.sedmelluq.discord.lavaplayer.tools.ExceptionTools: DEBUG

  # This will log all requests to the REST API
  request:
    enabled: true
    includeClientInfo: true
    includeHeaders: false
    includeQueryString: true
    includePayload: true

If Lavalink doesn't connect to Discord, make sure you forward the sessionId, token and enpoint to Lavalink via the player update endpoint.