Installation

Mon, 01 Jan 0001 00:00:00 +0000

Installation#

bgscan runs on Linux, macOS, Windows, and Android (Termux). Pick the method that fits your environment.

Quick Install#

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/MohsenBg/bgscan/refs/heads/main/scripts/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/MohsenBg/bgscan/refs/heads/main/scripts/install.ps1 | iex

Android (Termux)

pkg update -y && pkg install bash curl unzip -y && curl -fsSL https://raw.githubusercontent.com/MohsenBg/bgscan/refs/heads/main/scripts/install.sh | bash

The installer downloads the latest release, extracts it to bgscan/, and makes the binary executable. If a previous installation exists, it prompts you to remove it or back it up as bgscan_old.

Overview

Mon, 01 Jan 0001 00:00:00 +0000

Getting Started with bgscan#

Welcome to bgscan! This guide gives you a quick overview of what you’ll see after installation and how to run your first scan.

Launching bgscan#

Navigate to the installation folder and run the application:

Windows: Double-click bgscan.exe or run .\bgscan.exe in PowerShell
Linux/macOS/Termux: Run ./bgscan in your terminal

When you launch bgscan, you’ll see the main menu with the following options:

Option	Description
Run Scan	Start a new network scan
IP Files	Manage and select IP list files for scanning
Result Files	View and manage saved scan results
Settings	Configure scan parameters and preferences
Xray Outbounds	Manage Xray proxy configurations
Logs	View application and scan logs

Use these keyboard shortcuts to navigate:

Quick Start on Documentation