# Apache Guacamole

Apache Guacamole is a clientless remote desktop gateway. It supports standard protocols like VNC, RDP, and SSH.

# Docker Installation on ARM64

*Apache Guacamole is a powerful tool for managing remote connections, and installing it on a Raspberry Pi 4 with Docker allows for easy, remote access from almost anywhere*

---

## Prerequisites

1. Raspberry Pi 4
2. [Docker installed](https://bookstack.boreux.work/books/set-up/page/docker-installation-on-raspberry-pi-4-raspberrypi-os)


## Docker Compose Setup

For this installation, we will use a `compose.yaml` file with Docker Compose to manage the Guacamole installation.

<div class="callout info">I’m using the <a href="https://hub.docker.com/r/flcontainers/guacamole">flcontainers/guacamole</a> Docker image, which is compatible with the ARM64 architecture, unlike the official image.</div>

Here’s what the `compose.yaml` file should look like:

```yaml
services:
    guacamole_app:
        container_name: guacamole_app
        image: flcontainers/guacamole:latest
        restart: unless-stopped
        ports:
            - 8094:8080
        volumes:
            - guacamole_app-config:/config
            - /etc/localtime:/etc/localtime:ro
        environment:
            TZ: 'Europe/Brussels'
        healthcheck:
            test: curl -f -k http://127.0.0.1:8080/ || exit 1
            interval: 15s
            timeout: 10s
            retries: 5

volumes:
    guacamole_app-config:
        name: guacamole_app-config
```


## Installation

Once you’ve created the `compose.yaml` file, navigate to the directory where it’s stored and run the following command:

```bash
docker compose up -d
```

This command will pull the Guacamole image and install it on your Raspberry Pi.


## Using Apache Guacamole

After the installation, you can access the Guacamole web interface by visiting http://<YOUR_RPI_IP>:8094

<div class="callout info">
<b>Username:</b> guacadmin<br>
<b>Password:</b> guacadmin
</div>

---

With this setup, you now have Apache Guacamole running on your Raspberry Pi 4, allowing easy remote desktop access and management.

Happy me! 🌱