How to Install Zusam on Your Synology NAS

How to Install Zusam on Your Synology NAS

Zusam (/tsuĖˆzam/) is a free and open-source way to self-host private forums for groups of friends. Composed of a server written in PHP exposing a REST API and a lightweight webapp, Zusam is extensible and easy to install. The goal is to make a stable, extensible, lightweight and user-friendly way to self-host private social groups. In this step by step guide I will show you how to install ZusamĀ on yourĀ Synology NASĀ using Docker.

šŸ’”Note:Ā This guide works perfectly with the latest Zusam 0.5.6 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 zusamĀ Follow the instructions in the image below.
Note: Be careful to enter only lowercase, not uppercase letters.

Zusam 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.

Zusam 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 Zusam. 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=zusam \
-p 5560:8080 \
-v /volume1/docker/zusam:/zusam/data \
-e INIT_USER=marius \
-e INIT_PASSWORD=mariushosting \
--restart always \
zusam/zusam:0.5.3

Note: Before you paste the code above in the Run command area, change the value for INIT_USERĀ and add your own username. marius is an example of a username. You have to insert your own username.
Note: Before you paste the code above in the Run command area, change the value for INIT_PASSWORDĀ and add your own password. mariushosting is an example of a password. You have to insert your own password.

Zusam Synology NAS Set up 3 new 2023

  • STEP 6

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

Zusam Synology NAS Set up 4 new

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 Zusamā€ Task then click the ā€œRunā€ tab. You will be asked to run Install Zusam ā€“ click OK. Follow the instructions in the image below.

Zusam 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:5560 Type in your own Username and Password that you have previously created at STEP 5. Click Connection. Follow the instructions in the image below.

Zusam Synology NAS Set up 6

  • STEP 10

Click the little pencil icon in the bottom right to add new post. Follow the instructions in the image below.

Zusam Synology NAS Set up 7

  • STEP 11

Write something. Follow the instructions in the image below.

Zusam Synology NAS Set up 8

  • STEP 12

Scroll down the page. You can add your own picture, your own video and your own PDF file. Click Submit. Follow the instructions in the image below.

Zusam Synology NAS Set up 9

  • STEP 13

Your post is published!

Zusam Synology NAS Set up 10

  • STEP 14

You can reply to your own post or other users can do this. Follow the instructions in the image below.

Zusam Synology NAS Set up 11

  • STEP 15

Clicking on the icon in the upper left corner will give you access to the settings page where you can change the default icon and your credentials. Follow the instructions in the image below.

Zusam Synology NAS Set up 12

Enjoy Zusam!

Note: If you want to run the Zusam 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 Zusam 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 Sunday / January 26th, 2025 at 9:16 AM