Troubleshooting
This guide covers the most frequent issues encountered by users and provides step-by-step solutions to resolve them.
Connection Issues
Section titled “Connection Issues”WebSocket 401 Unauthorized
Section titled “WebSocket 401 Unauthorized”If your client fails to connect with a 401 error, verify your authorization header.
Client Timeout
Section titled “Client Timeout”If the connection times out after 10-20 seconds:
- Ensure the port (default
2333) is open in your firewall. - Check if you are using a reverse proxy (like Nginx/Cloudflare) and ensure WebSocket support is enabled.
Audio Quality
Section titled “Audio Quality”Audio Stuttering / Lag
Section titled “Audio Stuttering / Lag”Stuttering is usually caused by network congestion or CPU starvation.
- Check CPU Usage: Ensure the host isn’t hitting 100% CPU. Audio encoding is intensive.
- Network Jitter: Check the connection between Rustalink and Discord’s voice servers.
- Buffering: Increase the
buffer_duration_msin your configuration if the network is unstable.
High Memory Usage
Section titled “High Memory Usage”Rustalink is designed to be lean. If you see memory usage exceeding 200-300MB per 100 players:
- Check if you have extremely large queues.
- Ensure you are using the latest stable version.
Docker Specifics
Section titled “Docker Specifics”Localhost Access
Section titled “Localhost Access”If running in Docker, localhost refers to the container itself.
- Use
0.0.0.0as the address inconfig.tomlto allow external connections. - Ensure you have mapped the ports correctly:
-p 2333:2333.