CrackQ – Python GUI to Manage HashCat Jobs in a Queuing System


Feature List

  • Remote Python client or JS GUI
  • Cracked passwords analysis and reporting
  • Uses Hashcat API directly via libhashcat, no shell commands
  • Easy installation using docker containers
  • SQL, LDAP or SAML2 Authentication
  • Multi-user support with privilege separation for jobs
  • Job queues with pause/restore/move
  • Always supports the latest Hashcat version and algorithms
  • Email notifications when a hash cracks or job finishes
  • Intelligent queuing, new jobs added to the queue undergo a speed/show check immediately and will instantly show previously cracked hashes from the pot file without waiting
  • Automated Brain integration, Brain activates when it becomes efficient (uses above speed check)
  • Detailed job stats/charts for active jobs
  • Preconfigured rate-limiting
  • Markov stats pre-configured
  • Sample mask files included
  • Hashcat benchmark visualisations


This tool has the following requirements:

  • Drivers
    • OpenCL drivers – these can be installed from a repository or downloaded from the relevant vendor. Tested using Intel runtime.
    • Nvida drivers
    • AMD drivers
  • Docker
  • Nvidia-runtime
  • Docker-compose

It is recommended to have a hefty server build with ample RAM/CPU power. However, the application has been tested on a VM with 8 cores and 4GB RAM so there should not be any issues with resources given that the server will need a good amount of resources for cracking anyway.

See the Wiki for installation and guides.

Setup Docker

Install Docker CE on Ubuntu

Guide taken from here here:

sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \

curl -fsSL | sudo apt-key add -
sudo add-apt-repository \
   "deb [arch=amd64] \
   $(lsb_release -cs) \
sudo apt-get update
sudo apt-get install docker-ce

Install docker-compose

See here for latest version

sudo curl -L "$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Install Drivers

To Install OpenCL drivers follow the guide here:


For Nvidia you will need the nvidia container runtime package installed. Follow the steps here:

Ubuntu Nvidia Runtime Install

The Nvidia Runtime container toolkit is required to pass the GPUs through to the Docker containers.

distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L | sudo apt-key add -
curl -s -L$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list

sudo apt-get update && sudo apt-get install -y nvidia-container-toolkit
sudo systemctl restart docker
sudo apt-get install nvidia-container-runtime




When you have finished the pre-installation you then need to run the install script. It requires just one argument which is your preferred driver/os setup. This is the OS used by the docker container so it doesn’t necessarily need to be the same as the host OS:

sudo ./ docker/opencl/ubuntu


sudo ./ docker/nvidia/centos

After this the docker images will be built. However, some configuration is needed before launching. See the Configuration page for the next steps.

Note: There is an open issue with the latest Docker/Docker-compose version where docker-compose does not recognise the Nvidia runtime. If you see this error:

ERROR: for crackq Cannot create container for service crackq: Unknown runtime specified nvidia

Apply the workaround noted here. Which is just adding the following to your /etc/docker/daemon.json file:

    "runtimes": {
        "nvidia": {
            "path": "/usr/bin/nvidia-container-runtime",
            "runtimeArgs": []


Please follow and like us:

Leave a Reply

Your email address will not be published. Required fields are marked *