Install BotGateway in 5 Minutes

Follow our simple installation guide to protect your server from cyber threats.

Start InstallationWatch Demo First

System Requirements

  • Linux (Ubuntu 18.04+, Debian 9+, CentOS 7+), macOS 10.15+, or Windows Server 2016+
  • Root/Administrator access to install and configure
  • Minimum 512MB RAM, 1 CPU core
  • Open port for the firewall (default: 8080)
  • Outbound HTTPS access for dashboard sync
01

Download the Binary

Download the BotGateway Go binary for your operating system. We support Linux, macOS, and Windows.

# For Linux (x86_64)
curl -fsSL https://BotGateway.io/install.sh | sudo bash

# For macOS
brew install BotGateway

# For manual installation
wget https://releases.BotGateway.io/latest/BotGateway-linux-amd64
chmod +x BotGateway-linux-amd64
sudo mv BotGateway-linux-amd64 /usr/local/bin/BotGateway
02

Run the Installer

Initialize BotGateway and set up the systemd service for automatic startup.

# Initialize BotGateway
sudo BotGateway init

# This will:
# - Create config at /etc/BotGateway/config.yaml
# - Set up systemd service
# - Generate API keys for dashboard

# Start the service
sudo systemctl enable BotGateway
sudo systemctl start BotGateway

# Check status
sudo systemctl status BotGateway
03

Configure Security Rules

Customize your security rules based on your server's needs. Edit the config file or use the dashboard.

# Edit configuration
sudo nano /etc/BotGateway/config.yaml

# Example configuration:
server:
  port: 8080
  mode: proxy

protection:
  bot_detection: true
  sql_injection: true
  xss_prevention: true
  rate_limit:
    requests_per_second: 100
    burst_size: 200

rules:
  - path: "/admin/*"
    action: block
    except_ips: ["192.168.1.0/24"]
04

Monitor in Dashboard

Access your dashboard to view real-time attack logs, analytics, and manage your security rules.

# Get your dashboard credentials
sudo BotGateway credentials

# Output:
# Dashboard URL: https://dashboard.BotGateway.io
# API Key: sg_live_xxxxxxxxxxxxxxxx
# Server ID: srv_xxxxxxxx

# Or access locally
open http://localhost:8080/dashboard

What You'll See

Screenshots from the installation process and dashboard

Terminal Installation

Dashboard Overview

Ready to Get Started?

Start protecting your server now with our 14-day free trial.

Install NowNeed Help?