Installation Guide

This guide will walk you through installing PowBot on your Android device or emulator using the PowBot Installer.

System Requirements

Installer Requirements

• Java 11 or higher
• Internet connection for SDK download
• ~500MB disk space for installation

Device/Emulator Requirements

• Android 9 or later
• 2GB+ RAM minimum
• CPU with virtualization support (for emulator)
• Stable internet for bot operation

Note: The installer itself has minimal requirements. The actual PowBot client runs on Android devices or emulators which need sufficient resources for smooth operation.

Step 1: Install Java

PowBot requires Java 11 or higher to run. We recommend installing Java from Adoptium (formerly AdoptOpenJDK).

Download Java from Adoptium:

1. Visit adoptium.net
2. Click "Latest LTS Release" (Java 17 or 21 recommended)
3. Select your operating system and architecture
4. Download the installer (.msi for Windows, .pkg for macOS, .deb/.rpm for Linux)
5. Run the installer and follow the installation wizard

Verify Java Installation:

Open a terminal or command prompt and run:

java -version

You should see output showing Java version 11 or higher.

Step 2: Download and Run PowBot Installer

1. Download powbot-install.jar from the download page
2. Run the installer by either:
   • Option 1: Double-click the JAR file (if Java is properly configured)
   • Option 2: Run from terminal:

   java -jar powbot-install.jar
   

Step 3: Initial Setup

When the installer opens, you'll see the PowBot logo and a "Start Setup" button. Click it to begin the installation process.

Step 4: Android SDK Setup

The installer will automatically download and configure the Android SDK components needed to run PowBot. This process includes:

• Downloading Android SDK tools
• Installing platform tools
• Configuring emulator components

You'll need to accept the Android SDK license agreement. Review the terms and click "Accept" to continue.

Step 5: Select Device and Version

After SDK setup, you'll see the device selection screen:

PowBot Version: Choose between:

• Release - Stable version recommended for most users
• Beta - Latest features but may have bugs

Device: The installer will detect available devices/emulators:

• Physical devices connected via USB
• Android emulators running on your system

Bulk Install Mode: Toggle this option to install PowBot on multiple devices simultaneously.

Step 6: Install PowBot

With your device and version selected, click the "Install" button to begin the installation process.

The installer will now:

• Extract APK files
• Build PowBot for your selected device
• Install the application
• Configure necessary permissions

This process typically takes 2-5 minutes depending on your system performance.

Step 7: Launch PowBot

Installation complete! You now have two options:

• Launch PowBot: Click this button to start PowBot immediately
• Install Another: Install PowBot on additional devices

You can also launch PowBot later from your device's app drawer or home screen.

Troubleshooting

Java Installation Issues

Verify Java is installed correctly:

java -version

Should output: java version "11.0.x" or higher

If Java is not recognized:

• Ensure Java is in your system PATH
• Restart your terminal/command prompt after Java installation
• On Windows, check Environment Variables in System Settings

Running Installer from Terminal

Running from terminal provides detailed error messages that help diagnose issues:

Windows (Command Prompt or PowerShell):

cd Downloads
java -jar powbot-install.jar

macOS/Linux (Terminal):

cd ~/Downloads
java -jar powbot-install.jar

Collecting Logs for Support: If you encounter errors, copy the full terminal output and share it in our Discord help channel: discord.gg/powbot #help-channel

Reset PowBot Installation

If you're experiencing persistent issues, try deleting the PowBot data directory and reinstalling:

Windows:

rmdir /s %USERPROFILE%\.powbot

macOS/Linux:

rm -rf ~/.powbot

After deleting the directory, run the installer again for a fresh installation.

Common Error Messages

"No compatible devices found"

• Ensure your Android device/emulator is running
• Enable USB debugging on physical devices
• Check ADB connection: adb devices

"Could not create the Java Virtual Machine"

• Insufficient memory - close other applications
• Try with explicit memory allocation:

java -Xmx2G -jar powbot-install.jar

"Permission denied" (macOS)

• Right-click the JAR file → Open → Click "Open" in security dialog
• Or remove quarantine attribute:

xattr -d com.apple.quarantine powbot-install.jar

Still Need Help?

If you're still experiencing issues after trying these troubleshooting steps:

1. Run the installer from terminal to capture error logs
2. Take screenshots of any error messages
3. Join our Discord server: discord.gg/powbot
4. Post in the #help channel with your logs and system information

Our support team and community are active and ready to help!