Apache Guacamole — Deployment Template

Apache Guacamole App Template
This App Template deploys a fully configured Apache Guacamole instance inside an LXC container managed by the PUQcloud Proxmox Module.
The application runs in complete isolation using Docker, ensuring security, consistent performance, and separation for every user.

Each deployment is unique: PUQcloud automatically sets environment variables, creates required directories, configures storage paths, and deploys a fully functional Guacamole environment without manual steps.

Key Features

  • Runs inside an isolated LXC container (Proxmox)
  • Full Docker-based Guacamole installation with guacd and database
  • Auto-generated database credentials
  • Automatic reverse-proxy configuration (Nginx)
  • User-specific data directories (config, database)
  • Built-in health checks and service validation
  • No manual configuration needed

Dynamic Environment Variables

  • DATA_PATH – storage path for configuration and database
  • MYSQL_ROOT_PASSWORD – root DB password
  • MYSQL_PASSWORD – user DB password
  • MYSQL_USER – database username
  • MYSQL_DATABASE – database name
  • GUACD_HOSTNAME – guacd service hostname
  • MYSQL_HOSTNAME – database hostname

How it works

  1. PUQcloud Panel creates an LXC container via the Proxmox Module
  2. The template applies all required environment variables
  3. Storage paths are mounted into the container
  4. Docker Compose automatically deploys Guacamole, guacd, and MariaDB
  5. Nginx reverse proxy is configured with the correct domain and paths
  6. The Guacamole instance is ready to use

This template lets any user deploy a secure, isolated, and fully managed Guacamole environment in minutes.

Apache_Guacamole-docker-03728c4b-f181-4119-abfe-78293a0487dd.json (8.2 KB)