From Start to Finish: How to Install Navidrome on Debian

7 minutes reading time (1391 words)

12 Bookworm in Just a Few Simple Steps

As a music lover and tech enthusiast, I am always on the lookout for new and innovative ways to manage my music library. That's why I was so excited to learn about Navidrome, a lightweight and powerful music server that lets you stream your entire music collection from anywhere, on any device.

In this article, I'll walk you through the process of installing Navidrome on Debian 12 Bookworm, one of the most popular Linux-based operating systems for servers. With just a few simple steps, you can have Navidrome up and running on your Debian server, ready to serve up your favorite tunes.

What is Navidrome?

Before we dive into the installation process, let's take a moment to discuss what Navidrome is and why you might want to use it. Navidrome is an open-source music server that allows you to stream your music collection over the internet to any device, including smartphones, tablets, computers, and smart speakers.

One of the main benefits of Navidrome is that it is lightweight and easy to use, making it a great choice for anyone who wants a simple and reliable music server. Unlike some other music servers, Navidrome doesn't require a lot of resources to run, so it can be installed on even modest hardware without any issues.

Why use Debian 12 Bookworm for Navidrome?

While Navidrome can be installed on a variety of operating systems, I recommend using Debian 12 Bookworm for several reasons. First and foremost, Debian is one of the most stable and reliable Linux distributions available, making it an excellent choice for a server operating system.

In addition, Debian has a large and active community of developers and users, which means you can easily find help and support if you run into any issues during the installation process. Finally, Debian is highly customizable, so you can easily configure your server to meet your specific needs.

System requirements for Navidrome installation

Before you begin the installation process, it's important to ensure that your Debian server meets the minimum system requirements for Navidrome. Here are the recommended specifications:

  • A 64-bit operating system
  • 1GB of RAM or more
  • A modern CPU (Intel i3 or better)
  • At least 100GB of free disk space

If your server meets these requirements, you should be able to install Navidrome without any issues. However, if your server falls short in any of these areas, you may experience performance issues or other problems during the installation process.

Preparing your Debian server for Navidrome installation

Once you've confirmed that your server meets the system requirements for Navidrome, the next step is to prepare your server for installation. Here's what you need to do:

Step 1: Update your system

Before you install any new software on your server, it's important to ensure that your system is up to date. You can do this by running the following command:

sudo apt update && sudo apt upgrade

This will update all of the packages on your system to the latest versions.

Step 2: Install the required dependencies

Navidrome requires several dependencies to be installed on your system before it can be installed. You can install these dependencies by running the following command:

sudo apt install -y unzip ffmpeg libavcodec-extra libavformat-extra libavutil-dev libtagc0-dev

This will install the necessary packages for Navidrome to run.

Step 3: Create a non-root user

It's generally not recommended to run server software as the root user, as this can pose a security risk. Instead, you should create a non-root user to run Navidrome. You can create a new user with the following command:

sudo adduser navidrome

Follow the prompts to create a new user account.

Downloading and installing Navidrome

Now that your server is prepared, it's time to download and install Navidrome. Here's how to do it:

Step 1: Download Navidrome

You can download the latest version of Navidrome from the official website. At the time of writing, the latest version is Navidrome 0.43.0. You can download the file using the following command:


Step 2: Extract the Navidrome archive

Once the download is complete, you'll need to extract the Navidrome archive using the following command:


This will extract the Navidrome files to a new directory called "navidrome".

Step 3: Move Navidrome to the correct location

Next, you'll need to move the Navidrome directory to the correct location on your server. You can do this using the following command:

sudo mv navidrome /opt/

This will move the Navidrome directory to the "/opt" directory on your server.

Step 4: Set permissions and ownership

Before you can run Navidrome, you'll need to set the correct permissions and ownership for the Navidrome directory. You can do this using the following commands:

sudo chown -R navidrome:navidrome /opt/navidrome
sudo chmod -R 755 /opt/navidrome

These commands will ensure that the Navidrome directory is owned by the "navidrome" user and that the necessary permissions are set.

Step 5: Run Navidrome

Finally, you can run Navidrome using the following command:


This will start the Navidrome server. You should see a message indicating that Navidrome is running and listening on port 4533.

Configuring Navidrome for your music library

Now that Navidrome is up and running, it's time to configure it for your music library. Here's how to do it:

Step 1: Add your music library

The first step is to add your music library to Navidrome. You can do this by clicking on the "Settings" tab in the Navidrome web interface and then selecting "Music Folders". From here, you can add one or more folders containing your music files.

Step 2: Scan your music library

Once you've added your music folders, you'll need to scan your library to add the music files to Navidrome. You can do this by clicking the "Scan Library" button on the "Settings" tab.

Step 3: Configure Navidrome settings

Next, you'll need to configure the Navidrome settings to suit your preferences. This includes things like audio quality, playback settings, and user interface options.

Setting up user accounts and permissions

Now that your Navidrome server is up and running, you'll want to set up user accounts and permissions to ensure that your music library is secure. Here's how to do it:

Step 1: Create user accounts

You can create new user accounts in Navidrome by clicking on the "Settings" tab and selecting "Users". From here, you can add new users and set their permissions.

Step 2: Assign permissions

Once you've created your user accounts, you'll need to assign permissions to each user. This includes things like read-only access, playlist editing, and administrative access.

Step 3: Restrict access

Finally, you may want to restrict access to your Navidrome server to only certain users or IP addresses. You can do this by configuring your server's firewall settings or using a VPN.

Securing your Navidrome installation

In addition to setting up user accounts and permissions, there are several other steps you can take to secure your Navidrome installation. Here are some tips:

  • Use a strong password for your Navidrome user account
  • Keep your operating system and Navidrome installation up to date with the latest security patches
  • Use HTTPS encryption to encrypt data transmitted between your devices and Navidrome
  • Use a virtual private network (VPN) to secure your connection to Navidrome

Troubleshooting common Navidrome installation issues

While the installation process for Navidrome is generally straightforward, you may encounter some issues along the way. Here are some common issues and how to fix them:

  • Navidrome won't start: Check that you've set the correct permissions and ownership for the Navidrome directory
  • Can't connect to Navidrome: Check that your firewall settings allow incoming connections on port 4533
  • Music library isn't scanning: Check that you've added your music folders correctly and that Navidrome has the necessary permissions to access them


Navidrome is a powerful and easy-to-use music server that can help you stream your entire music collection from anywhere, on any device. By following the steps outlined in this article, you can install and configure Navidrome on your Debian 12 Bookworm server in just a few simple steps.

Whether you're a music enthusiast or a professional DJ, Navidrome is a great choice for anyone who wants a reliable and convenient music server. So why not give it a try today and see how it can revolutionize the way you listen to music?

Font size: +
Report Print
Stay Informed

When you subscribe to the blog, we will send you an e-mail when there are new updates on the site so you wouldn't miss them.

By accepting you will be accessing a service provided by a third-party external to