acspri/quexs repository overview

⁠What is queXS?

queXS⁠ is a free and open source Computer Assisted Telephone Interviewing (CATI) system based on PHP and MySQL, including LimeSurvey.

⁠How to use this image

$ docker run --name some-quexs --link some-mysql:mysql -d acspri/quexs

The following environment variables are also honored for configuring your queXS instance:

• -e QUEXS_DB_HOST=... (defaults to the IP and port of the linked mysql container)
• -e QUEXS_DB_USER=... (defaults to "root")
• -e QUEXS_DB_PASSWORD=... (defaults to the value of the MYSQL_ROOT_PASSWORD environment variable from the linked mysql container)
• -e QUEXS_DB_NAME=... (defaults to "quexs")
• -e QUEXS_PATH=... (defaults to "/" - set this to "/quexs" for example if running in a subdirectory)
• -e QUEXS_PORT=... (defaults to "" - set this to ":8080" for example if running on port 8080)
• -e QUEXS_ADMIN_PASSWORD=... (defaults to "" - set this to update the admin password)

If the QUEXS_DB_NAME specified does not already exist on the given MySQL server, it will be created automatically upon startup of the quexs container, provided that the QUEXS_DB_USER specified has the necessary permissions to create it.

If you'd like to be able to access the instance from the host without the container's IP, standard port mappings can be used:

$ docker run --name some-quexs --link some-mysql:mysql -p 8080:80 -d acspri/quexs

Then, access it via http://localhost:8080 or http://host-ip:8080 in a browser.

If you'd like to use an external database instead of a linked mysql container, specify the hostname and port with QUEXS_DB_HOST along with the password in QUEXS_DB_PASSWORD and the username in QUEXS_DB_USER (if it is something other than root):

$ docker run --name some-quexs -e QUEXS_DB_HOST=10.1.2.3:3306 \
    -e QUEXS_DB_USER=... -e QUEXS_DB_PASSWORD=... -d acspri/quexs

⁠... via docker-compose⁠

Example docker-compose.yml for quexs:

version: '2'

services:

  quexs:
    image: quexs
    ports:
      - 8080:80
    environment:
      QUEXS_DB_PASSWORD: example
      QUEXS_PORT: :8080

  mysql:
    image: mariadb
    environment:
      MYSQL_ROOT_PASSWORD: example

Run docker-compose up, wait for it to initialize completely, and visit http://localhost:8080 or http://host-ip:8080.

⁠Supported Docker versions

This image is officially supported on Docker version 1.12.3.

Support for older versions (down to 1.6) is provided on a best-effort basis.

Please see the Docker installation documentation⁠ for details on how to upgrade your Docker daemon.

⁠Notes

A default username and password is created:

admin
password

This Dockerfile is based on the Wordpress official docker image⁠