Uploaded image for project: 'Guacamole'
  1. Guacamole
  2. GUACAMOLE-374

Installing Guacamole with Docker improvements

    XMLWordPrintableJSON

    Details

    • Type: Improvement
    • Status: Open
    • Priority: Minor
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: guacamole-docker
    • Labels:
      None
    • Environment:

      Description

      I installed guacamole as docker container for the first time. Great software! I followed the guide on https://guacamole.incubator.apache.org/doc/gug/guacamole-docker.html. There is a lot of unnecessary work to get the container up and running, here are some suggestions to improve the documentation:

      1. The link flag is a deprecated legacy feature of Docker. It may eventually be removed. Legacy container links . It is no problem to get guacamole running with a user defined network.
      2. The database should be generated automatically on first run. The user and database could be automatically created by mariadb.
      3. ...You should add mariadb as possible backend.
      4. Due to its complexity (three services) you should provide a docker-compose.yml file for use with docker-compose. This also creates an user defined network.

      Here is an example docker-compose.yml for use with mariadb:

      version: '3'
      
      services:
        guacd:
          image: guacamole/guacd
          depends_on:
            - db
      
        guac:
          image: guacamole/guacamole
          ports:
            - 8080:8080
          depends_on:
            - db
            - guacd
          environment:
            - GUACD_HOSTNAME=guacd
            - MYSQL_PASSWORD=x
            - MYSQL_DATABASE=guacamole_db
            - MYSQL_USER=guacamole_user
            - MYSQL_HOSTNAME=db
      
        db:
          image: mariadb
          volumes:
            - /srv/docker/guacamole-mysql:/var/lib/mysql
          environment:
            - MYSQL_ROOT_PASSWORD=x
            - MYSQL_PASSWORD=x
            - MYSQL_DATABASE=guacamole_db
            - MYSQL_USER=guacamole_user
      

      I don't know why, but GUACD_HOSTNAME and MYSQL_HOSTNAME are needed (maybe a bug?)

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                Unassigned
                Reporter:
                svengo Sven Gottwald
              • Votes:
                2 Vote for this issue
                Watchers:
                5 Start watching this issue

                Dates

                • Created:
                  Updated: