Getting Started

This guide will walk you through the initial setup process for a new Hashtopolis installation.

• Configure Hashcat (Optional): Hashtopolis agents use Cracker Binaries to work on tasks and recover passwords from provided hashlists. By default, Hashtopolis includes an Hashcat release as Cracker Binary. If you need more flexibility, you can add other Hashcat releases to the Cracker Binaries -> New Binary section. Hashcat releases can be found on the official website. The chosen Cracker Binary will be automatically uploaded and used by the agents.

• Configure Server: Navigate to Config -> Server and customize the settings according to your needs. Refer to the Hashtopolis documentation for detailed information on each configuration option.

• Groups (Optional): If you plan to manage users and agents with different permissions, create groups in the Users -> Groups section. You can then assign users and agents to these groups for granular access control.

• Add a hashlist: Upload your first hashlist containing the hashes of the passwords you want to recover. Navigate to the Lists -> New Hashlist section. Check the Hashlists wiki page for more information on Hashlist creation and operations.

• Add files (Optional): If you plan to run tasks with wordlists/rules, upload them in the Files section.

• Register an agent: To register an agent, create a voucher, download the binary from the Agents -> New Agent page, run it on a compute machine and enter the URL to connect to the server, followed by a valid voucher to register the client to the server. See Client Prerequisites and Installation

• Adjust Permissions: By default, newly registered agents are marked as "Untrusted" and uploaded files are marked as "Secret." An untrusted agent cannot work on tasks that require access to secret files. The agent will need to be marked as trusted or the file marked as not secret in order for work to begin.

• Create a task: Navigate to the section Tasks -> New Task to create your first task.Here, you will specify the hashlist, any required files, and the chosen Hashcat binary for password cracking.

• Start Cracking: After you registered all your agents, Created a task(s), and Set the task(s) priority to greater than 0, lean back grab a (Coffee|Beer) and wait for cracks ;)