veeQuery installation and setup

License Notice: veeQuery-free as it names implies is free to use. Please read license terms and restrictions here: https://vqueryfree.com/license/


veeQuery runs in a docker container. A container platform is needed to host the application, such as docker or kubernetes.

Get the image from dockerhub: https://hub.docker.com/r/vquery/veequery-free

or

Download the image with the following docker command: docker pull vquery/veequery-free

There are many ways to set up veeQuery, especially in an enterprise context where security, high availability and scalability are needed. In this guide we will focus on the installation of the free version of veeQuery which is more suited for personal use. For more information on the differences between the free version and the full version please visit “About” tab.

Requirements:

  • Operating system: Windows, Linux or Mac OS
  • Docker (or any container platform that can run Docker images)
  • Computer memory: depends on the size of the files to process. 16Gb is a good start.
  • Recommended Web Browsers: Chrome, Edge

Installation steps:

  • Download and install Docker
  • Configure Docker to host Linux containers (if installing on Windows)
  • download veeQuery image: docker pull vquery/veequery-free

Configure and run veeQuery:

veeQuery runs on port 8866 by default.

The following volumes can be mounted:

  • one for users workspace: every file generated by the user through the application will be stored in it.
    • <directory_or_network_share_on_the_host>:/vQuery
  • Additional volumes can be mounted as shares (read only):
    • <directory_or_network_share_on_the_host>:/shares/<share_name>

If you want to quickly test veeQuery you can run:

  • docker run --name veequery -d vquery/veequery-free:latest

It is important to map a volume as you may lose your data (data files, queries, connections, credentials) if the container is destroyed.

Connect to veeQuery:

How you connect to veeQuery will mostly depend on the location of the machine running veeQuery container. In the simplest scenario - running the container on your computer - you can acess the application at the following url:

http://localhost:8866/

When connecting to the URL for the first time, you will be prompted to set a new password for the admin user. If you did not map a local folder you will be greeted by a warning asking you to do so.