How to Install Guacamole on Your Synology NAS

How to Install Guacamole on Your Synology NAS

Apache Guacamole is a clientless remote desktop gateway. It supports standard protocols like VNC, RDP, and SSH. We call it clientless because no plugins or client software are required. Thanks to HTML5, once Guacamole is installed on a server, all you need to access your desktops is a web browser. Because the Guacamole client is an HTML5 web application, use of your computers is not tied to any one device or location. As long as you have access to a web browser, you have access to your machines. In this step by step guide I will show you how to install Guacamole on your Synology NAS using Docker.

  • STEP 1

Please Support My work by Making a Donation.

  • STEP 2

Install Docker via Synology “Package Center”.

Install Docker Synology DSM 7

  • STEP 3

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

Guacamole Synology NAS Set up 1

  • STEP 4

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

Guacamole 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 Guacamole. Uncheck “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=guacamole \
-p 8348:8080 \
-e PUID=1026 \
-e PGID=100 \
-e TZ=Europe/Bucharest \
-v /volume1/docker/guacamole:/config \
--restart always \
oznu/guacamole

Note: Before you paste the code above in the Run command 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 Run command area below, change the value for TZ (Select your current Time Zone from this list).

Guacamole Synology NAS Set up 3

  • STEP 6

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

Guacamole Synology NAS Set up 4

  • STEP 7

After you click OK on STEP 6, select your “Install Guacamole” Task then click the “Run” tab. You will be asked to run Install Guacamole – click Yes. Follow the instructions in the image below.

Guacamole 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:8348 add Username and Password then click Login. Follow the instructions in the image below.

Warning: the default username is guacadmin and the default password is guacadmin

Guacamole Synology NAS Set up 6

  • STEP 10

Once you are logged in, the first step is to change your default username and password. Go to your guacamole settings and change them according to your preference. Enjoy your Apache-Guacamole docker container!

Guacamole Synology NAS Set up 7

Change the default guacadmin username and password.

Guacamole Synology NAS Set up 8

Note: If you want to run this container over an HTTPS check How to Run Docker Containers Over HTTPS.

Note: Find out how to update Guacamole container with the latest image.
Note: Can I run Docker on my Synology NAS? See the supported models.
Note: How to Free Disk Space on Your NAS if You Run Docker.
Note: How to Schedule Start & Stop For Docker Containers.

This post was updated on Thursday / October 21st, 2021 at 8:48 PM