Deploy QualiX using Docker

This process deploys two docker containers, quali_hub/qualix_guacamole and quali_hub/qualix_guacd, and the network they will use to communicate with each other.

Docker for Windows is not supported.

Note: Make sure to have docker together with iptables when running containers on a linux vm

To deploy QualiX using Docker:

  1. Install Docker Engine, as explained in this docker docs article.
  2. Install Docker Compose, as explained in this docker docs article.
  3. Run the following from the /opt/ directory:

    sudo wget https://quali-prod-binaries.s3.amazonaws.com/guacamole-quali-install-docker.sh
    sudo chmod +x guacamole-quali-install-docker.sh
    sudo ./guacamole-quali-install-docker.sh
  4. Start the QualiX container stack by running the following from the /opt/qualix directory:

    sudo ./start.sh

  5. To verify that QualiX is up and running, run the following:

    sudo status
  6. After deploying QualiX on docker, continue with Post Installation Configuration.

Additional Options

To stop QualiX (stops the container stack):

sudo stop

To restart QualiX after boot (inactive docker):

sudo systemctl enable docker

To get the docker logs:

See Docker logs.

To attach the docker container to a shell:

sudo docker exec -it <container_id>/bin/sh -c "[ -e /bin/bash ] && /bin/bash || /bin/sh"

To destroy running containers:

sudo docker stop guacamole guacd
sudo docker rm guacamole guacd

To start the containers:

cd /opt/qualix
sudo ./start.sh