====== Guacamole ======

[[informatica:software:aplicaciones_web|Aplicación web]] para acceder remotamente a sistemas mediante [[informatica:software:ssh|SSH]], [[informatica:rdp|RDP]] o VNC.

  * [[https://guacamole.apache.org/|Web oficial]]

===== Instalación =====

==== Docker ====

Apuntes basados en el ''docker-compose.yml'' de [[https://github.com/boschkundendienst/guacamole-docker-compose/blob/master/docker-compose.yml|este repositorio de Github]].

Necesitamos 3 contenedores para poner en marcha 3 componentes

  * Servidor de Guacamole: guacd
  * Guacamole
  * Base de datos PostgreSQL

Crearemos dos directorios en la misma ubicación que el fichero ''docker-compose.yml'':

  * ''data'': para persistir la base de datos
  * ''init'': para incluir los scripts de inicialización de la base de datos.

Generaremos un script para inicializar la base de datos mediante:

<code>
docker run --rm guacamole/guacamole /opt/guacamole/bin/initdb.sh --postgresql > ./init/initdb.sql
</code>

<code yaml>
---
services:
  guacd:
    image: guacamole/guacd
    container_name: guacd
    ports:
      - 4822:4822
    restart: unless-stopped
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"
        
  guacamole:
    image: guacamole/guacamole
    container_name: guacamole
    environment:
      GUACD_HOSTNAME: guacd
      GUACD_PORT: 4822
      POSTGRES_DATABASE: guacamole_db
      POSTGRES_HOSTNAME: postgres
      POSTGRES_PASSWORD: 'ChooseYourOwnPasswordHere1234'
      POSTGRES_USER: guacamole_user
    ports:
      - 8080:8080
    restart: unless-stopped
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"        

  postgres:
    image: postgres
    container_name: guacamole-db
    environment:
      PGDATA: /var/lib/postgresql/data/guacamole
      POSTGRES_DB: guacamole_db
      POSTGRES_PASSWORD: ChooseYourOwnPasswordHere1234
      POSTGRES_USER: guacamole_user
    restart: unless-stopped
    volumes:
    - ./init:/docker-entrypoint-initdb.d:ro
    - ./data:/var/lib/postgresql/data
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"
</code>

Si todo funciona correctamente, Guacamole estará disponible desde http://localhost:8080/guacamole/

Las credenciales por defecto de Guacamole:

  * Usuario: ''guacadmin''
  * Contraseña: ''guacadmin''