kleprevost / saladcat

A distributed hashcat implementation using Salad Cloud and Hashtopolis

SaladCat

A distributed hashcat implementation using Salad Cloud and Hashtopolis

DockerHub Link

Blog Writeup

Overview

SaladCat provides a convenient way to quickly scale hashcat deployments on Salad Cloud and Hashtopolis. Salad Cloud offers an affordable and efficient platform with access to a large pool of consumer-grade GPUs, making it ideal for this type of work.

Features

• Quick deployment of hashcat on Salad Cloud
• Integration with Hashtopolis for distributed computing
• Automation scripts for easier management

Getting Started

Prerequisites

1. Salad Cloud Account
   • Requires an initial $50 deposit to get started.
2. Hashtopolis Server
   • A Hashtopolis server running on any cloud service except Salad Cloud.
   • For quick and easy deployment, refer to Nikita's guide.

Configuration

There are two essential environment variables that need to be configured on your Salad Container Group resource:

1. API_SERVER_URL
   • Format: http://<hashtopolis_server_ip>:<port>/api/server.php
2. VOUCHER
   • Value: Voucher code from your Hashtopolis server.

Ensure your Hashtopolis server is configured to allow a single voucher to be used multiple times. This can be set in /config.php?view=5 under the "Vouchers can be used multiple times and will not be deleted automatically."

Usage

Automation Scripts

Two scripts are included to automate tasks:

1. create_salad_hashcat.py

   • Automates the creation of a new Salad Cloud container group.
   • Saves time by defining environment variables programmatically.

2. update_agents.py

   • Interacts with the Hashtopolis API to configure agents as trusted and to ignore errors.
   • Optionally assigns an agent to a specific task number.
   • Useful for managing multiple cracking nodes for a specific task.

Contributions

Contributions to improve the project are welcome. If you find ways to optimize the Docker container or improve functionality, please feel free to submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Contact

For any questions or support, please reach out via GitHub issues.