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

1 install docker synology dsm

  • STEP 3

Open the Docker Package. From the Docker Console, go to Registry and search guacamole. Look for oznu/guacamole and select it, then click Download or double click on it. You will be prompted to Choose Tag, select latest. Follow the instructions in the image below.

1 Synology NAS install Guacamole docker setup

  • STEP 4

After you click “Select”, the download process of the Guacamole docker container will start. You can click on Image on the Docker Console to see the download progress. The current container is about 1 GB. Follow the instructions in the image below.

2 Synology NAS install Guacamole docker setup

  • STEP 5

After the download is completed from the Docker Console, go to Image, then select the oznu/guacamole:latest container. Click Launch. Check “Execute container using high privilege”, then click Advanced Settings. Follow the instructions in the image below.

3 Synology NAS install Guacamole docker setup

  • STEP 6

Select Enable auto-restart. Follow the instructions in the image below.

4 Synology NAS install Guacamole docker setup

  • STEP 7

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.

5 Synology NAS install Guacamole docker setup6 Synology NAS install Guacamole docker setup

  • STEP 8

The final result should look like this. Follow the instructions in the image below.

7 Synology NAS install Guacamole docker setup

  • STEP 9

Now go back to the Docker Package. Next tab – “Volume“. Select Add Folder. Choose the guacamole folder, then click Select. Follow the instructions in the image below.

8 Synology NAS install Guacamole docker setup

  • STEP 10

After you click Select, type /config inside Mount path for the guacamole folder. Follow the instructions in the image below. Your Volume will look like this:

9 Synology NAS install Guacamole docker setup

  • STEP 11

Next tab – “Network“ move forward without doing anything (no action needed).
Next tab – “Port Settings“ on Local Port area type 8085 instead of Auto, then click “Apply“. Follow the instructions in the image below.

10 Synology NAS install Guacamole docker setup

  • STEP 12

After clicking “Apply“on STEP 11, the screen below will open. Click “Next“. Follow the instructions in the image below.

11 Synology NAS install Guacamole docker setup

  • STEP 13

After clicking “Next“, the screen below will open. Select “Run this container after the wizard is finished” then click “Apply“. Follow the instructions in the image below.

12 Synology NAS install Guacamole docker setup

  • STEP 14

Your container will look like this:

13 Synology NAS install Guacamole docker setup

  • STEP 15

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

  • STEP 16

Now open your browser and type in http://Synology-ip-address:8085/ Follow the instructions in the image below. Choose Username and Password then click Next.

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

14 Synology NAS install Guacamole docker setup

  • STEP 17

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!

15 Synology NAS install Guacamole docker setup

16 Synology NAS install Guacamole docker setup

  • STEP 18

Read the step by step guide on How to Allow Guacamole to Work Over an HTTPS Connection.

Note: Find out how to update Guacamole container with the latest image.
Note: I recommend you use Reverse Proxy to allow Guacamole to work over an HTTPS connection.
Note: Can I run Docker on my Synology NAS? See the supported models.

This post was updated on Monday / August 31st, 2020 at 7:56 PM