How to Install Logitech Media Server on Your Synology NAS

How to Install Logitech Media Server on Your Synology NAS

Logitech Media Server is a streaming audio server supported by the LMS community and formerly supported by Logitech, developed in particular to support their Squeezebox range of digital audio receivers. In this step by step guide I will show you how to install Logitech Media Server on your Synology NAS using Docker & Portainer.

💡Note: This guide works perfectly with the latest Logitech Media Server v.9.0.0 release.

  • STEP 1

Please Support My work by Making a Donation.

  • STEP 2

Install Portainer using my step by step guide. If you already have Portainer installed on your Synology NAS, skip this STEP. Attention: Make sure you have installed the latest Portainer version.

  • STEP 3

Go to File Station and open the docker folder. Inside the docker folder, create one new folder and name it lms. Follow the instructions in the image below.
Note: Be careful to enter only lowercase, not uppercase letters.

Logitech Media Server Synology NAS Set up 1

  • STEP 4

Now create two new folders inside the lms folder that you created at STEP 3 and name them music and playlist. Follow the instructions in the image below.
Note: Be careful to enter only lowercase, not uppercase letters.

Logitech Media Server Synology NAS Set up 2

  • STEP 5

Populate your music folder with your own music. Follow the instructions in the image below.

Logitech Media Server Synology NAS Set up 3 new 2025

  • STEP 6

Log into Portainer using your username and password. On the left sidebar in Portainer, click on Stacks then + Add stack. Follow the instructions in the image below.

1 Synology Portainer Add Stack

  • STEP 7

In the Name field type in lms. Follow the instructions in the image below.

Note: Copy Paste the code below in the Portainer Stacks Web editor.

version: "3.9"
services:
  lms:
    container_name: Logitech-Media-Server
    image: lmscommunity/logitechmediaserver
    healthcheck:
      test: timeout 10s bash -c ':> /dev/tcp/127.0.0.1/9002' || exit 1
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 90s
    volumes:
      - /volume1/docker/lms:/config:rw
      - /volume1/docker/lms/music:/music:ro
      - /volume1/docker/lms/playlist:/playlist:rw
      - /etc/localtime:/etc/localtime:ro
      - /etc/TZ:/etc/timezone:ro
    ports:
      - 9002:9002/tcp
      - 9090:9090/tcp 
      - 3483:3483/tcp
      - 3483:3483/udp
    environment:
       HTTP_PORT: 9002
       PUID: 1026
       PGID: 100
       TZ: Europe/Bucharest
       EXTRA_ARGS: "--advertiseaddr=192.168.1.18" # Your Own Synology Local NAS IP
    restart: on-failure:5

Note: Before you paste the code above in the Web editor area below, change the value numbers for PUID and PGID with your own values. (Follow my step by step guide on how to do this.)
Note: Before you paste the code above in the Web editor area below, change the value for TZ. (Select your current Time Zone from this list.)
Note: Before you paste the code above in the Web editor area below, change the value for 192.168.1.18. Type in your own Synology Local NAS IP. 192.168.1.18 is my own Synology Local NAS IP.

Logitech Media Server Synology NAS Set up 4

  • STEP 8

Scroll down on the page until you see a button named Deploy the stack. Click on it. Follow the instructions in the image below. The installation process can take up to a few minutes. It will depend on your Internet speed connection.

Logitech Media Server Synology NAS Set up 5

  • STEP 9

If everything goes right, you will see the following message at the top right of your screen: “Success Stack successfully deployed“.

Logitech Media Server Synology NAS Set up 6

  • STEP 10

Go back to STEP 1 or you will deal with karma 🙂

  • STEP 11

The installation process can take up to a few seconds/minutes. It will depend on your Internet speed connection. Now open your browser and type in http://Synology-ip-address:9002 If everything goes right, you will see the Logitech Media Server dashboard. Click on the Music Folder. Follow the instructions in the image below.

Logitech Media Server Synology NAS Set up 7

  • STEP 12

Your music that you have previously added at STEP 5 should appear in this area.

Logitech Media Server Synology NAS Set up 8

  • STEP 13

Logitech Media Server is a server and, to play music, you need a client that acts as player. To explain how to set up a new player on your Logitech Media Server, I will use Winamp as an external player that is installed on my Windows 11 PC. You can also use VLC or other players. Open Winamp, then right click on it. A new pop up window will open. Click Play, then URL. Follow the instructions in the image below.

Logitech Media Server Synology NAS Set up 9

  • STEP 14

In the URL field, type in your local NAS IP followed by :9002/stream.mp3 Then click Open. Follow the instructions in the image below. 192.168.1.18 is my own local NAS IP. You should use your own local NAS IP.

http://192.168.1.18:9002/stream.mp3

Logitech Media Server Synology NAS Set up 10

  • STEP 15

Open your Logitech Media Server page. Choose Winamp as a player. Select your favorite songs, then click + to add them to the playlist. Start the playlist. Follow the instructions in the image below.

Logitech Media Server Synology NAS Set up 11

  • STEP 16

Click Play on your Winamp media player and your music will be on air. Follow the instructions in the image below.

Logitech Media Server Synology NAS Set up 12

  • STEP 17

Thanks to Logitech Media Server, you can also stream Radio on air. Follow the instructions in the image below.

Logitech Media Server Synology NAS Set up 13

Enjoy Logitech Media Server!

🆘TROUBLESHOOTING

If you encounter issues by using this container, make sure to check out the Common Docker issues article.

Note: If you want to run the Logitech Media Server container over HTTPS, check How to Run Docker Containers Over HTTPS. In order to make Logitech Media Server work via HTTPS, it’s mandatory to activate WebSocket. Remember: if you want to use the player to play music, you need to port forward ports 3483 (TCP/UDP), 9090 (TCP), 9002 (TCP) in your router pointing to your local NAS IP. It’s also mandatory to change the address at STEP 14 from http://yournasIP:9002/stream.mp3 to https://lms.yourname.synology.me/stream.mp3

Note: Can I run Docker on my Synology NAS? See the supported models.
Note: How to Back Up Docker Containers on your Synology NAS.
Note: Find out how to update the Logitech Media Server container with the latest image.
Note: How to Free Disk Space on Your NAS if You Run Docker.
Note: How to Schedule Start & Stop For Docker Containers.
Note: How to Activate Email Notifications.
Note: How to Add Access Control Profile on Your NAS.
Note: How to Change Docker Containers Restart Policy.
Note: How to Use Docker Containers With VPN.
Note: Convert Docker Run Into Docker Compose.
Note: How to Clean Docker.
Note: How to Clean Docker Automatically.
Note: Best Practices When Using Docker and DDNS.
Note: Some Docker Containers Need WebSocket.
Note: Find out the Best NAS Models For Docker.
Note: Activate Gmail SMTP For Docker Containers.

This post was updated on Saturday / June 29th, 2024 at 4:08 AM