Quick Install (Linux)

The easiest way to install SAGAN on Linux is with the shell installer:

# Install to current directory
curl -sSf https://lbc.cryptoguru.org/static/client/install.sh | bash

# Or with wget
wget -qO- https://lbc.cryptoguru.org/static/client/install.sh | bash

Options:

# Install to specific directory
curl -sSf https://lbc.cryptoguru.org/static/client/install.sh | SAGAN_DIR=/opt/sagan bash

# Force specific CPU flavor
curl -sSf https://lbc.cryptoguru.org/static/client/install.sh | SAGAN_FLAVOR=znver4 bash

The installer will:

  • Auto-detect your OS and CPU micro-architecture
  • Download the best optimized binary for your system
  • Verify the SHA-256 checksum
  • Create a sagan symlink for easy execution

Quick Start

After installation, getting started takes just a few steps:

  1. Execute SAGAN — it will:
    • Create a configuration file (lbc.toml)
    • Check for updates to itself
    • Download the bloom filter file (.blf) if not present
  2. Optionally edit the config file to customize settings
  3. Start colliding!

Manual Downloads

If you prefer to download manually, choose the appropriate build for your system. If unsure, use the generic x86_64 version — SAGAN will auto-update to an optimized build for your CPU.

Linux

Build Description Download
x86_64 Generic 64-bit (works on any x86_64 CPU) sagan-0.1.6-linux-x86_64
Skylake Intel Skylake and newer sagan-0.1.6-linux-skylake
Skylake-AVX512 Intel with AVX-512 support sagan-0.1.6-linux-skylake-avx512
Zen 2 AMD Ryzen 3000 series and newer sagan-0.1.6-linux-znver2
Zen 4 AMD Ryzen 7000 series and newer (AVX-512) sagan-0.1.6-linux-znver4

Windows

Build Description Download
x86_64 Generic 64-bit (works on any x86_64 CPU) sagan-0.1.6-windows-x86_64.exe
Skylake Intel Skylake and newer sagan-0.1.6-windows-skylake.exe
Skylake-AVX512 Intel with AVX-512 support sagan-0.1.6-windows-skylake-avx512.exe
Zen 2 AMD Ryzen 3000 series and newer sagan-0.1.6-windows-znver2.exe
Zen 4 AMD Ryzen 7000 series and newer (AVX-512) sagan-0.1.6-windows-znver4.exe

Configuration

On first run, SAGAN creates a lbc.toml configuration file in the current directory. You can edit this file to customize:

  • Your client ID (for stats tracking)
  • Number of threads to use
  • GPU settings (if applicable)
  • Server connection settings

Requirements

  • 64-bit operating system (Linux or Windows)
  • ~500 MB disk space for bloom filter
  • Internet connection for server communication
  • Optional: OpenCL-capable GPU for accelerated computation