Installing 3g-scan

Three installation methods to suit your needs

Recommended

⚡ Method 1 — Automatic Installation Script

The fastest and easiest method. The script automatically downloads the latest version and installs it on your system.

curl -fsSL https://raw.githubusercontent.com/0adri3n/3g-scan/refs/heads/master/docs/install.sh | bash

Verify installation with: 3g-scan -h

⚠️ Run PowerShell as Administrator

iwr https://raw.githubusercontent.com/0adri3n/3g-scan/refs/heads/master/docs/install.ps1 -UseBasicParsing | iex

Verify installation with: 3g-scan -h

📦 Method 2 — Manual Binary Download

Download the executable for your platform from the latest GitHub release.

📥 Download Latest Release

Linux / macOS

chmod +x 3g-scan
sudo mv 3g-scan /usr/local/bin/

Windows

  1. Download 3g-scan.exe
  2. Place it in a directory of your choice
  3. (Optional) Add the directory to your PATH

🛠️ Method 3 — Build from Source

Recommended if you want to modify the code, audit the implementation, or compile for a custom platform.

Prerequisites

  • Go 1.20+
  • Git

Build Steps

git clone https://github.com/0adri3n/3g-scan.git
cd 3g-scan
go build -o 3g-scan

Run with: sudo ./3g-scan -h

🔐 Required Permissions

3g-scan must be run with elevated privileges:

Linux / macOS sudo 3g-scan
Windows Terminal in Administrator mode

Required for ICMP requests and ARP table access

Next Steps

Now that 3g-scan is installed, check out the full documentation to discover all features.

View Documentation