Skip to main content

Installation Guide

This guide provides detailed instructions for installing BozoBot on different operating systems.

System Requirements​

BozoBot is designed to be lightweight and can run on most modern systems:

  • CPU: Any modern dual-core processor
  • RAM: Minimum 2GB (4GB recommended)
  • Disk Space: 50MB free space
  • Network: Stable internet connection
  • Operating System:
    • Windows 10/11
    • macOS 10.15 or later (Intel & Apple Silicon)
    • Linux (Ubuntu 18.04+, Debian 10+, CentOS 8+)

Installation Steps​

Windows​

  1. Download the latest Windows version from our official distribution
  2. Extract the ZIP file to a location of your choice
  3. Inside the extracted folder, you'll find:
    • bozobot.exe - The executable file
    • .env - Configuration file
    • snipe-list.txt - Optional list for token sniping
  4. Edit the .env file with your configuration (see Environment File Configuration)
  5. Double-click bozobot.exe or run via Command Prompt to start the bot

macOS​

  1. Download the appropriate macOS version (Intel or Apple Silicon)
  2. Extract the ZIP file to a location of your choice
  3. Open Terminal and navigate to the extracted folder: 
    cd path/to/extracted/folder
  4. Make the executable file runnable: 
    chmod +x bozobot
  5. Edit the .env file with your configuration (see Environment File Configuration)
  6. Run the bot: 
    ./bozobot

macOS Security Notice​

When running BozoBot on macOS for the first time, you might see a security warning. To resolve this:

  1. Right-click (or Control-click) on the bozobot file
  2. Select "Open" from the context menu
  3. Click "Open" when prompted
  4. For future runs, you can simply double-click the file

Linux​

  1. Download the Linux version from our official distribution
  2. Extract the ZIP file: 
    unzip bozobot.zip -d bozobot
  3. Navigate to the extracted directory: 
    cd bozobot
  4. Make the executable file runnable: 
    chmod +x bozobot
  5. Edit the .env file with your preferred text editor: 
    nano .env
  6. Run the bot: 
    ./bozobot

Verifying Your Installation​

To verify that BozoBot is running correctly:

  1. The bot should display a startup message in the console
  2. Check for any error messages during startup
  3. If using sniffer mode, the bot will prompt you to authenticate with Telegram on first run

Running in the Background​

For information on running BozoBot in the background or as a service, see the Running 24/7 AFK Guide.

Updating BozoBot​

When a new version is released:

  1. Download the latest version
  2. Extract to a new directory
  3. Copy your existing .env and snipe-list.txt files to the new directory
  4. Run the new version of BozoBot

Your settings will be preserved through the update process.