Apache Guacamole¶

Apache Guacamole is used to remote into GUI based systems, such as Windows 11

Installation¶

Default Port: 8080

Url: http://ip-address:8080/guacamole

Configuration path: /etc/guacamole/guacd.conf

Default username: guacadmin

Default uassword: guacadmin

AMD64ARM64

bash -c "$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/raw/main/ct/apache-guacamole.sh)"

bash -c "$(wget -qLO - https://github.com/asylumexp/Proxmox/raw/main/ct/apache-guacamole.sh)"

Config¶

Windows 11¶

Connections

Edit ConnectionNetworkAuthentication

Name: w11

Location: Root

Protocol: RDP

Hostname: 192.168.2.154

Port: 3389

Username: username

Password: password

Domain: W11

Info

Domain should match the hostname of the W11 computer.

Traefik¶

homelab/pve/traefik/conf.d/apache-guacamole.yaml

---
http:
 #region routers 
  routers:
    apache-guacamole:
      entryPoints:
        - "websecure"
      rule: "Host(`guac.l.nicholaswilde.io`)"
      middlewares:
        - guacamole-add-prefix
        - default-headers@file
        - https-redirectscheme@file
      tls: {}
      service: apache-guacamole
#endregion
#region services
  services:
    apache-guacamole:
      loadBalancer:
        servers:
          - url: "http://192.168.2.156:8080"
        passHostHeader: true
#endregion
  middlewares:
    guacamole-add-prefix:
      addprefix:
        prefix: "/guacamole"

Task List¶

task: Available tasks for this project:
* decrypt:       Decrypt .env using SOPS
* enable:        Enable service
* encrypt:       Encrypt .env using SOPS
* export:        Export the task list
* init:          Init
* mklinks:       Make client symlinks
* restart:       Resart service
* start:         Start service
* status:        Service status
* stop:          Stop service
* update:        Update running containers
* upgrade:       Upgrade app