How to Install Astro on Your Synology NAS

How to Install Astro on Your Synology NAS

Astro is a simple, open source, extensible, lightweight dashboard for all of your selfhosted services. It’s similar to more complex dashboards like Homarr, Heimdall, Flame, Dashy and Homepage. In this step by step guide I will show you how to install Astro on your Synology NAS using Docker.

šŸ’”Note: This guide works perfectly with the latest Astro 0.5.0Ā release.

  • STEP 1

Please Support My work by Making a Donation.

  • STEP 2

Install Container Manager via Synology ā€œPackage Centerā€. If you run an older DSM version (under 7.2), search for Docker instead of Container Manager.

Download Container Manager Synology Docker

  • STEP 3

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

Astro Synology NAS Set up 1

  • STEP 4

Go to Control Panel / Task Scheduler / Create / Scheduled Task / User-defined script. Follow the instructions in the image below.

Astro Synology NAS Set up 2

  • STEP 5

Once you click on User-defined script, a new window will open. Follow the instructions below:

  1. General: In the Task field type in Install Astro. Uncheck the ā€œEnabledā€ option. Select rootĀ User.
  2. Schedule: SelectĀ Run on the following dateĀ then select ā€œDo not repeatā€œ.
  3. Task Settings: Check ā€œSend run details by emailā€œ, add your email then copy paste the code below in the Run command area. After that, click OK.
docker run -d --name=Astro \
-p 8897:8088 \
-v /volume1/docker/astro:/app/server/data \
igorsheg/astro

Astro Synology NAS Set up 3

  • STEP 6

After you click OK on STEP 5 a new warning pop up window will open. Click OK.

Astro Synology NAS Set up 4

After you click OK, type in your DSM Password then click Submit. Follow the instructions in the image below.

Synology Task Scheduler Confirm Admin Password

  • STEP 7

After you click Submit on STEP 6, select your ā€œInstall Astroā€ Task then click the ā€œRunā€ tab. You will be asked to run Install Astro ā€“ click OK. Follow the instructions in the image below.

Astro Synology NAS Set up 5

  • STEP 8

šŸŸ¢Please Support My work by Making a Donation. Almost 99,9% of the people that install something using my guidesĀ forget to support my work, or justĀ ignoreĀ STEP 1. Iā€™ve been very honest about this aspect of my work since the beginning: I donā€™t run any ADS, I donā€™t require subscriptions, paid or otherwise, I donā€™t collect IPs, emails, and I donā€™t have any referral links from Amazon or other merchants. I also donā€™t have any POP-UPs or COOKIES. I have repeatedly been told over the years how much I have contributed to the community. Itā€™s something I love doing and have been honest about my passion since the beginning. But I also Need The Community to Support me Back to be able to continue doing this work.

  • STEP 9

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:8897 Add your new service. Follow the instructions in the image below.

Astro Synology NAS Set up 6

  • STEP 10

Create new service then click Submit. Follow the instructions in the image below.

Astro Synology NAS Set up 7

Enjoy Fenrus!

šŸ†˜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 Astro container over HTTPS, check my guide on How to Run Docker Containers Over HTTPS.

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 Astro 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 Monday / January 6th, 2025 at 3:56 PM