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.
Install Docker via Synology “Package Center”.
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.
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.
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.
Select Enable auto-restart. Follow the instructions in the image below.
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.
The final result should look like this. Follow the instructions in the image below.
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.
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:
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.
After clicking “Apply“on STEP 11, the screen below will open. Click “Next“. Follow the instructions in the image below.
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.
Your container will look like this:
Go back to STEP 1 or you will deal with karma 🙂
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.
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!
STEP 18 Run Container via HTTPS
Read the step by step guide on How to Allow Guacamole to Work Over an HTTPS Connection. Method 1.
Read Synology: HTTPS-SSL to Your Docker Containers Without Port at The End. Method 2.
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 Tuesday / April 20th, 2021 at 12:12 AM