selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

NodeLink logo

Self-host NodeLink

v3.9.0

Lavalink-compatible audio server built in Node.js

ReleaseOpen SourceGPL-3.0
Updatedlast week
LanguageTypescript
Setup difficultyModerate
Stars
162
Ports
3000 (HTTP/WebSocket server (default config)), 2333 (Lavalink-compatible WebSocket port (Docker default))
Docker
ghcr.io/performanc/nodelink
Install with Docker

What is NodeLink?

NodeLink is a self-hosted audio server built completely in Node.js that implements the Lavalink API for Discord music bots and real-time audio applications. It uses a worker-based architecture where each player runs in its own process for isolation and scalability. The server includes built-in audio filters such as an equalizer, time scaling, tremolo, compression, echo, chorus, and phaser effects. It exposes Prometheus metrics for production monitoring and works with many music providers. Deployment options include Docker, Docker Compose, or a manual Node.js installation requiring version 22 or higher. The project is licensed under GPL-3.0 and maintained by the PerformanC organization.

Should you self-host NodeLink?

NodeLink scores 50/100 on selfhost.directory (how scoring works) and ranks #7 of 14 in Audio Streaming. It has 162 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v3.9.0, came out on 14 September 2026. New versions land roughly every 3 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Snapcast (72/100, 8 038 stars). It scores higher overall, so compare the two before you pick. See NodeLink vs Snapcast side by side.

Features

  • Audio mixing
  • Cluster mode
  • Lavalink-compatible API
  • Low memory footprint
  • Lyrics Support
  • Multi-source support
  • Native audio processing
  • Plugin System
  • Prometheus Metrics
  • Rate limiting & DoS protection
  • Real-time audio filters
  • Voice receive (relay)Disabled by default
  • Worker-based architecture

NodeLink README

How to install NodeLink

Install NodeLink with Docker

Docker Engine
Environment variables
NODELINK_SERVER_PASSWORD, NODELINK_CLUSTER_ENABLED, NODELINK_SOURCES_SPOTIFY_ENABLED, etc.

docker run -p 2333:2333 ghcr.io/performanc/nodelink:latest

Pre-built stable release image from GitHub Container Registry

NodeLink releases & version history

More in Audio Streaming

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…