Agent Guide¶

Overview¶

Agents are the computational workhorses of KrakenHashes, responsible for executing password cracking jobs using hashcat. This guide covers all aspects of agent deployment, configuration, and management.

Quick Start¶

Download the agent binary from the Releases page
Generate a claim code in the Admin UI

Register the agent:

./krakenhashes-agent register --code YOUR_CLAIM_CODE --server https://your-server:31337

Start the agent:
```
./krakenhashes-agent
```

Guide Contents¶

Setup and Configuration¶

Installation - Installing and setting up agents
Configuration - Agent configuration options
File Synchronization - How agents sync files with the backend

Operations¶

Scheduling - Configure working hours and availability
Device Management - GPU and device configuration
Monitoring - Performance metrics and health checks

Troubleshooting¶

Common Issues - Solutions to frequent problems
Logs and Debugging - Finding and understanding agent logs

Key Concepts¶

Agent Registration¶

Agents use a claim code system for secure registration: - One-time codes: Single use, automatically deactivated - Continuous codes: Can register multiple agents - API keys: Generated during registration for ongoing authentication

Device Support¶

KrakenHashes agents support multiple device types: - NVIDIA GPUs (CUDA) - AMD GPUs (OpenCL) - Intel GPUs (OpenCL) - CPU-based cracking (fallback)

File Management¶

Agents automatically manage required files: - Wordlists are downloaded on-demand - Rules are cached locally - Hashcat binaries are auto-updated - All files are verified using checksums

Security¶

Agent security features: - TLS encrypted communication - API key authentication - No inbound connections required - Certificate validation