How to Setup Heimdall on a Synology NAS

Today we are going to look at how to setup Heimdall on a Synology NAS using Docker.

Heimdall is an awesome little tool that will allow you to create a nice dashboard to access all of your home lab services or webpages. After it’s set up, you simply add a new service, enter the information and a new “service” will appear on your dashboard. From there, you can either navigate to this page to access all of your services or set it as your homepage.

There are different options that you can set up (accounts, background options, etc.), and it functions relatively well on a Synology NAS.

1. Instructions - How to Setup Heimdall on a Synology NAS

1. Ensure that the Docker package is installed on your Synology NAS.

2. Create a subfolder under the Docker folder named Heimdall, then create a subfolder inside of that folder named config. We will use this folder at a later step to map our configuration files.

how to setup heimdall on a synology nas

3. Launch Docker and download the linuxserver/Heimdall image from the Registry.

synology nas heimdall 2

4. When it’s done downloading, double-click the Image to launch the configuration.

synology nas heimdall 3

5. Give the container a Name, then select Advanced Settings.

synology nas heimdall 4

6. Select Enable auto-restart, then select Volume.

synology nas heimdall 5

7. Select Add Folder, then map the folder that we created earlier to the /config mount path. Keep in mind that this is the folder that will contain all of your personal data. Therefore, if you’d like to back up your data, you will need to back up this folder using a tool like Hyper Backup.

synology nas heimdall 12

8. In the Port Settings section, change the Auto port for 443 to 8081 and the Auto port for 80 to 8080. NOTE: If you are using these ports for anything else on your Synology NAS, you will have to use different ports.

synology nas heimdall 6

9. Select Next and then create the container. Give the container about five minutes, and then stop the container and restart it. This step was necessary for me, as Heimdall would not be accessible until the container was restarted. If you’d like to try it before restarting, you can, but this was my experience.

10. After the container has been restarted, navigate to the IP address of your Synology NAS and port 8080.

http://SYNOLOGY_NAS_IP:8080

11. When the webpage loads, you can now configure it! Select add an application here to add whatever service you’d like.

synology nas heimdall 7

12. When you’re done adding all your services, you will have a dashboard that will automatically connect you to all of your services! At this point, you can also add an administrator account password if you’d like (select the person icon in the bottom right).

synology nas heimdall 9

2. Conclusion

This tutorial showed how to setup Heimdall on a Synology NAS. If you’re running a bunch of different services from your local network (doesn’t necessarily have to be on your NAS), this is an awesome tool to manage them all. It’s very customizable, easy to set up, and can look pretty cool when you’re done configuring it!

The video tutorial has a few additional settings that are no shown here. They include setting up an administrator login and password, changing the background, and configuring a few other settings. If you’d like to see any of those, please skip to the middle of the YouTube video at the top of this screen. Please keep in mind that none of this is necessary, but Heimdall allows you to take it one step further and change these settings if you’d like.

Thanks for checking out the tutorial. If you have any questions, feel free to leave them in the comments!

This Post Has 5 Comments

  1. Great tutorial, helped me a lot, thank you! Could you, please, make a tutorial on accessing Synology NAS, when using VPN? My ISP is very strict at my work place and almost all ports are closed/deep inspected. So I was trying to connect to ddns using your tutorial, but nothing works. I tried to use VPN and access ddns address, didn’t work as well

  2. Thanks for the reply. Yes, that’s where my NAS is located. I did follow your tutorial, tried connecting NAS over VPN, tried to connect to NAS’s network over VPN (by setting it up like in your video), tried to connect via DDNS, port forwarding, nothing works except quickconnect, but it is terribly slow unfortunately. Something like Tailscale works, but slow as well.

    1. Also when using DDNS, the status is normal, upnp is set up, but to luck actually connecting to it

      1. I think that it’s better to try and focus on one approach and get that working as mixing these could make things a lot more confusing when trying to troubleshoot.

        If DDNS is working, it should be used in the VPN config file as shown in that tutorial. Can you confirm that UDP port 1194 is open on your router?

Comments are closed.

Close Menu