ScreenerBot
DocsGetting StartedInstallation Guide
ScreenerBot
ScreenerBot

Need Help?

Join our community for support, updates, and trading discussions.

Telegram ChannelTelegram GroupFollow on X (Twitter)Contact Support

Installation Guide

ScreenerBot is available as a bundled executable for macOS, Windows, and Linux. You can also run it on your own server for 24/7 operation. Choose your platform below.

Choose Your Platform

macOS

Big Sur and later

  • Apple Silicon (M1/M2/M3/M4)
  • Intel processors
  • DMG installer

Windows

Windows 10 and 11

  • 64-bit (x64)
  • ARM64 (Snapdragon)
  • MSI/EXE installer

Linux

Desktop installation

  • Ubuntu, Debian, Fedora
  • x64 and ARM64
  • DEB/RPM packages

VPS / Server

24/7 headless operation

  • Systemd service setup
  • Auto-restart on crash
  • Remote access setup

System Requirements

Minimum

  • CPU4 cores
  • RAM4 GB
  • Storage8 GB free space
  • NetworkStable broadband

Suitable for testing and light trading with limited positions.

Recommended

  • CPU8 cores
  • RAM8 GB
  • Storage15 GB free space
  • NetworkFast broadband

Best for active trading with multiple positions and strategies.

Best Performance

  • CPU8+ cores
  • RAM16 GB
  • Storage25 GB free space
  • NetworkPremium broadband

Ideal for heavy trading, extensive monitoring, and long-term data retention.

Prerequisites

Before You Install

  • Solana Wallet: Private key in base58 format for your trading wallet
  • RPC URLs: At least one Solana RPC endpoint (free or premium)
  • Fast Internet: Stable connection for real-time blockchain data
  • SOL for Trading: Funds in your wallet for trades and transaction fees

Data Directory

After first launch, ScreenerBot creates a data directory in your system's standard location:

Base Directory Location

macOS:~/Library/Application Support/ScreenerBot
Windows:%LOCALAPPDATA%\ScreenerBot
Linux:
$XDG_DATA_HOME/ScreenerBot(fallback: ~/.local/share/ScreenerBot)

Folder Structure

ScreenerBot/
├── data/
│   ├── config.toml              # Main configuration (contains encrypted wallet)
│   ├── tokens.db                # Token metadata, market data, security info
│   ├── positions.db             # Trading positions, entry/exit history
│   ├── transactions.db          # Transaction history
│   ├── pools.db                 # Pool discovery and price cache
│   ├── wallet.db                # Wallet balance snapshots
│   ├── events.db                # Event logging
│   ├── strategies.db            # Trading strategies
│   ├── ohlcvs.db                # Candlestick data
│   ├── rpc_stats.db             # RPC provider statistics
│   ├── ata_failed_cache.json    # ATA cleanup cache
│   └── token_blacklist.json     # Blacklisted tokens
├── logs/
│   ├── screenerbot_*.log        # Daily rotating log files
│   └── latest.log               # Symlink to current log
└── analysis-exports/            # Exported CSV files

Automatic Creation: All directories and files are created automatically on first launch. You don't need to create anything manually.

Backup Important Files: Keep backups of config.toml which contains your encrypted wallet data.

Next Steps

Download ScreenerBot
Previous

Get the latest version

Initial Setup
Next

Configure your wallet and RPC settings