How to Install PupCloud on Your Synology NAS

How to Install PupCloud on Your Synology NAS

Put your files in the browser! Point Pupcloud to a local folder and instantly get its contents exposed as a web application. Browse, manage, share files and more in a truly portable way! Pupcloud doesn’t need a database, nor it leaves .dotfiles in the filesystem; it is packaged as a single executable file (written in Go+Svelte+Typescript). Pupcloud is an exercise in minimalism: it aims to be as simple as possible while retaining all the features you would like it to have. Just run it! It has everything and it fits in a pup-sized cloud. In this step by step guide I will show you how to install PupCloud on your Synology NAS using Docker.

💡Note: This guide works perfectly with the latest Pupcloud 0.8.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 pupcloud. Follow the instructions in the image below.
Note: Be careful to enter only lowercase, not uppercase letters.

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

Synology User Defined Script

  • 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 PupCloud. 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=pupcloud \
-p 9138:17178 \
-v /volume1/docker/pupcloud:/data \
--restart always \
chown -R 1000:1000 /volume1/docker/pupcloud

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

Pupcloud 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 PupCloud” Task then click the “Run” tab. You will be asked to run Install PupCloud – click OK. Follow the instructions in the image below.

Pupcloud Synology NAS Set up 5

  • STEP 8

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

  • 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:9138 Create new folder and upload new files! Follow the instructions in the image below.

Pupcloud Synology NAS Set up 6

All your uploaded files at a glance!

Pupcloud Synology NAS Set up 7

Enjoy PupCloud & Read the full PupCloud documentation!


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 PupCloud 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 PupCloud 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 / February 24th, 2024 at 5:48 AM