Running Apache Guacamole in Docker 🌱

What is Apache Guacamole?

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. - https://guacamole.apache.org/

Installing Docker

1. Log into the Linux host
2. Run the following commands in a terminal window
   # install prerequisites
   sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg-agent -y
   # add docker gpg key
   curl -fsSL https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release)/gpg | sudo apt-key add -
   # add docker software repository
   sudo add-apt-repository "deb [arch=$(dpkg --print-architecture)] https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release) $(lsb_release -cs) stable"
   # install docker
   sudo apt install docker-ce docker-compose containerd.io -y
   # enable and start docker service
   sudo systemctl enable docker && sudo systemctl start docker
   # add the current user to the docker group
   sudo usermod -aG docker $USER
   # reauthenticate for the new group membership to take effect
   su - $USER

Running Apache Guacamole

1. Continue with the following commands in terminal to setup and run Guacamole
   # create working directories
   mkdir ~/docker/mariadb -p
   # set owner of docker directory
   sudo chown "$USER":"$USER" ~/docker -R
   # download the guacamole container
   docker pull guacamole/guacamole
   # run the mariadb docker container
   docker run -d --name mariadb -e MYSQL_ROOT_PASSWORD=r00tp@ss -v ~/docker/mariadb:/var/lib/mysql --restart=unless-stopped mariadb:latest
   # create database init script
   docker run --rm guacamole/guacamole /opt/guacamole/bin/initdb.sh --mysql > ~/docker/mariadb/guacamole_db.sql
   # connect to mariadb container shell
   docker exec -ti mariadb /bin/bash
   # connect to mariadb as root user
   mysql -uroot -pr00tp@ss
   # create the database
   create database guacamole;
   # create and configure the database user
   GRANT ALL ON guacamole.* TO 'guacamole_rw'@'%' IDENTIFIED BY 'Guac@m0le!';
   # flush mariadb privileges
   flush privileges;
   # exit mariadb cli
   quit
   # import the guacamole schema
   cat /var/lib/mysql/guacamole_db.sql | mysql -uroot -pr00tp@ss -Dguacamole
   # exit the maridb container shell
   exit
   # run the guacd container
   docker run -d --name guacd guacamole/guacd
   # run the guacamole container
   docker run -d --name guacamole --link guacd --link mariadb -e MYSQL_HOSTNAME=mariadb -e MYSQL_DATABASE=guacamole -e MYSQL_USER=guacamole_rw -e MYSQL_PASSWORD=Guac@m0le! -p 8080:8080 guacamole/guacamole
2. Open a web browser and navigate to http://DNS-or-IP:8080/guacamole/
3. Log in with guacadmin/guacadmin
4. Go to Settings > Users
5. Create a new user and grant all permissions
6. Log out and log in as the new user
7. Go to Settings > Users > Delete the guacadmin user
8. Go to Settings > Connections > New Connection
9. Setup a test connection to a known working host
10. Click Save
11. Go to Home > Click on the created connection
12. Enjoy browser based SSH, VNC, RDP and more

Documentation: https://guacamole.apache.org/doc/gug/guacamole-docker.html