Back to articles
DevOps & Systems

Building a High-End Private Music Streaming System with Navidrome and Subsonic Client

Establish a secure, high-performance private music streaming system using Navidrome and a Subsonic client, enabling users to access their personal music libraries safely,...

DPTCloud Engineering4 min read
Building a High-End Private Music Streaming System with Navidrome and Subsonic Client

Establish a secure, high-performance private music streaming system using Navidrome and a Subsonic client, enabling users to access their personal music libraries safely, efficiently, and without limitations. With Docker, Nginx, and NVMe Cloud VPS, you can deploy the entire system on a virtual server at low cost, with high security and easy scalability. This guide provides step-by-step instructions to configure Navidrome as a music server, integrate it with the Subsonic API, and set up a user-friendly interface on mobile devices or desktops.

Requirements and Environment Preparation

To deploy a private music streaming system, you need a Linux-based VPS (Ubuntu 22.04 or equivalent) with Docker and Docker Compose installed. An NVMe Cloud VPS is ideal due to its high read/write speeds, suitable for handling multiple concurrent music streams. You also need a domain name (or static IP) for remote access and an SSL certificate to secure connections. If you don’t have one, you can sign up for a NVMe Cloud VPS for Docker, Nginx & Databases.

Deploying Navidrome with Docker

Navidrome is an open-source music server compatible with the Subsonic protocol, allowing users to access their music libraries from any device. To deploy, create a `docker-compose.yml` file with the following content:

version: '3.8'
services:
  navidrome:
    image: navidrome/navidrome:latest
    container_name: navidrome
    ports:
      - "4533:4533"
    volumes:
      - ./navidrome/data:/data
      - ./navidrome/config:/config
      - ./music:/music
    environment:
      ND_LOG_LEVEL: info
      ND_PORT: 4533
      ND_BASEURL: /navidrome
      ND_ADMIN_PASSWORD: your_secure_password
      ND_MUSIC_FOLDER: /music
    restart: unless-stopped

Replace `your_secure_password` with a strong admin password. The `music` directory contains your music library and must be mounted into the container. After creating the file, run:

docker-compose up -d

Navidrome will start and be accessible at `http://your-server-ip:4533`. You can configure the user interface, add users, and manage your music library through the web dashboard.

Integrating Subsonic Client and Securing the Connection

Subsonic clients (such as Subsonic for Android or iOS) support the Subsonic API, which is compatible with Navidrome. In the app, enter the server address (`http://your-server-ip:4533/navidrome`) and your account password. To enhance security, use Nginx as a reverse proxy and integrate Let's Encrypt to obtain a free SSL certificate. Create an Nginx configuration file (`/etc/nginx/sites-available/navidrome`):

server {
    listen 80;
    server_name your-domain.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl;
    server_name your-domain.com;

    ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;

    location / {
        proxy_pass http://localhost:4533;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Run the following commands:

sudo nginx -t
sudo systemctl reload nginx

To automatically issue an SSL certificate, use Certbot:

sudo certbot certonly --nginx -d your-domain.com

Managing Music Library and Customization

Navidrome automatically scans the music library from the mounted directory. To optimize performance, you can configure the music folder in the `config.json` file or through the web interface. Below are common configuration options:

  • Music folder: Set the `ND_MUSIC_FOLDER` in the `docker-compose.yml` file or via the admin interface.
  • Audio analysis: Navidrome automatically generates metadata from audio files.
  • Library sharing: Allow users to create private libraries or share public ones.
  • User management: Create user accounts, assign access permissions, and set playback limits.

Verification and Troubleshooting

After configuration, verify the system by accessing `https://your-domain.com/navidrome`. If it fails to load, check the Navidrome container logs:

docker logs navidrome

Ensure the `music` directory is correctly mounted and has readable permissions. If the Subsonic client cannot connect, verify that the Subsonic protocol is enabled in Navidrome (it is enabled by default) and that port 4533 is not blocked by the firewall. Use `sudo ufw allow 4533` to open the port if needed.

Resources and References

For more information about Navidrome, refer to the official documentation at https://navidrome.org/. Nginx and Let's Encrypt configuration guides are available at https://certbot.eff.org/instructions. If you need a high-performance server for your music streaming system, see High-Performance Dedicated Servers for Production Clusters.

Related infrastructure & engineering guides: Monetizing VPS: 10 Real Business Models Trending in 2026

DPTCloud Tier III Infrastructure

Recommended NVMe Cloud VPS Plans to Deploy This Setup

Enterprise RAID 10 NVMe SSDs, CMC & FPT District 9 uplinks with Anycast Anti-DDoS and 99.99% SLA.

View 22 VPS Plans
ECO · vn-02

VPS-2E

94.600 ₫ / mo

10% VAT included

  • CPU: 2 vCPU
  • RAM: 2 GB
  • SSD: 30 GB NVMe
ECO · vn-02Recommended

VPS-3E

170.500 ₫ / mo

10% VAT included

  • CPU: 2 vCPU
  • RAM: 4 GB
  • SSD: 50 GB NVMe
BASIC · vn-01Recommended

VPS-05

457.600 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Related Articles

View all
ZaloZalo SupportDiscord0384 753 478