Skip to content

Home

Jump to bottom
H9Crawler edited this page Apr 24, 2026 · 2 revisions
███████╗████████╗██╗ ██╗██╗███████╗██╗ ██╔════╝╚══██╔══╝██║ ██║██║██╔════╝██║ █████╗ ██║ ███████║██║█████╗ ██║ ██╔══╝ ██║ ██╔══██║██║██╔══╝ ██║ ███████╗ ██║ ██║ ██║██║██║ ██║ ╚══════╝ ╚═╝ ╚═╝ ╚═╝╚═╝╚═╝ ╚═╝

Welcome to the official EthiFi Wiki

Affordable WiFi Pentesting Platform for Testing & Learning

🌐 haybnz.web.app  ·  🐙 GitHub Repo  ·  🐛 Report an Issue

License Platform Build Stars

👋 Welcome

This is the official documentation wiki for EthiFi — an open-source, affordable WiFi pentesting platform powered by the ESP8266 microcontroller.

Whether you're a beginner just unboxing your first ESP8266, or an experienced researcher looking to customize the firmware, this wiki has everything you need to get started and go further.

⚠️ EthiFi is for educational and authorized use only. Always test on networks you own or have explicit permission to test. Unauthorized use is illegal.

📖 Wiki Pages

Navigate the full documentation using the sidebar or the links below:

🚀 Getting Started

Page Description
Home You are here — overview and navigation
Getting Started First steps after flashing — connect & access the Web UI
Supported Hardware Compatible ESP8266 boards and what to buy
Flash Size Guide How to choose the right flash size for your module

📖 Full hardware guide → Supported Hardware

💾 Flash Size Warning

⚠️ Selecting the wrong flash size during installation will cause the firmware to malfunction.

Different ESP8266 modules ship with different flash sizes. Always verify your board's flash size before flashing.

ESP8266 Modules

📖 Full guide → Flash Size Guide

🔧 Driver Not Installed?

If your computer doesn't detect the board when plugged in, you need a USB-to-Serial driver. Most boards use either CP2102 or CH340.

Serial Chip Types

📖 Full installation steps → Driver Installation

🩺 Having Issues?

Check the Troubleshooting page for solutions to the most common problems:

  • 🔴 Board not detected by computer
  • 🔴 Flash fails or disconnects
  • 🔴 Web UI won't load at 192.168.4.1
  • 🔴 Arduino IDE won't show Deauther boards
  • 🔴 Upload errors

Can't find your issue? Open a GitHub Issue and the community will help.

⚖️ Disclaimer

EthiFi is developed strictly for educational and authorized security research.

  • ✅ Use on networks you own
  • ✅ Use with explicit permission from the network owner
  • ❌ Never use on public or unauthorized networks

The developer accepts no responsibility for misuse. See Disclaimer & Legal for full details.

👨‍💻 About the Developer

EthiFi is built and maintained by h9zdev.

🌐 haybnz.web.app  ·  🐙 github.com/h9zdev

<div align="center">

📄 License (MIT)  ·  ⭐ Star on GitHub

This wiki is maintained by the EthiFi community. Found an error? Open an issue or submit a PR.

</div> 
███████╗████████╗██╗  ██╗██╗███████╗██╗
██╔════╝╚══██╔══╝██║  ██║██║██╔════╝██║
█████╗     ██║   ███████║██║█████╗  ██║
██╔══╝     ██║   ██╔══██║██║██╔══╝  ██║
███████╗   ██║   ██║  ██║██║██║     ██║
╚══════╝   ╚═╝   ╚═╝  ╚═╝╚═╝╚═╝     ╚═╝

Welcome to the official EthiFi Wiki

Affordable WiFi Pentesting Platform for Testing & Learning

🌐 [haybnz.web.app](https://haybnz.web.app/)  ·  🐙 [GitHub Repo](https://github.com/h9zdev/EthiFi)  ·  🐛 [Report an Issue](https://github.com/h9zdev/EthiFi/issues)

License Platform Build Stars

👋 Welcome

This is the official documentation wiki for EthiFi — an open-source, affordable WiFi pentesting platform powered by the ESP8266 microcontroller.

Whether you're a beginner just unboxing your first ESP8266, or an experienced researcher looking to customize the firmware, this wiki has everything you need to get started and go further.

⚠️ EthiFi is for educational and authorized use only. Always test on networks you own or have explicit permission to test. Unauthorized use is illegal.

📖 Wiki Pages

Navigate the full documentation using the sidebar or the links below:

🚀 Getting Started

Page Description
Home You are here — overview and navigation
Getting Started First steps after flashing — connect & access the Web UI
Supported Hardware Compatible ESP8266 boards and what to buy
Flash Size Guide How to choose the right flash size for your module

🛠️ Installation

Page Description
Installation — NodeMCU Flasher Easiest method, Windows only, no coding required
Installation — Arduino IDE Full source compile and upload for developers
Driver Installation CP2102 and CH340 USB driver setup

📡 Usage

Page Description
Web UI Guide How to use the browser-based control panel
Scanning Networks Find nearby access points and clients
Deauth Attack How deauthentication frames work
Beacon Spam Broadcasting fake SSIDs
Probe Monitor Capturing probe requests from nearby devices

🩺 Help & Support

Page Description
Troubleshooting Common problems and how to fix them
FAQ Frequently asked questions

⚖️ Legal

Page Description
Disclaimer & Legal Authorized use, laws, and responsibilities

⚡ What is EthiFi?

EthiFi is a low-cost WiFi security research platform built on the ESP8266 — a tiny $3 microcontroller with built-in WiFi. It runs a web server you control from any browser, making WiFi pentesting concepts accessible to everyone.

🔑 Key Capabilities

🔧 Feature 📝 What it does
📡 Deauth Attack Sends deauthentication frames to disconnect WiFi clients
🔍 Network Scanner Lists nearby access points and their connected clients
🎭 Beacon Spam Floods the area with dozens of fake SSIDs
🕵️ Probe Monitor Logs probe requests broadcast by nearby devices
💻 Web UI Full control from a browser — no app, no drivers needed for control
💸 Affordable Total hardware cost as low as ~$3

🔌 Quick Start

1. Flash EthiFi to your ESP8266 — see Installation — NodeMCU Flasher or Installation — Arduino IDE

2. Power on your board and connect to the WiFi it creates:

SSID:     EthiFi
Password: deauther

3. Open your browser and go to:

http://192.168.4.1

4. You're in! 🎉 Use the Web UI to scan, select, and test.

📖 Full guide → Getting Started

🛒 Recommended Hardware

EthiFi runs on any ESP8266 board. Here are the best options to buy:

🖥️ Board 💰 Price 🌟 Best For
NodeMCU v2 ~$3–5 Beginners — most tutorials use this
Wemos D1 Mini ~$3–4 Compact builds
DSTIKE Deauther ~$10–15 Dedicated pentesting device with OLED
ESP-01 ~$1–2 Ultra-minimal, needs extra adapter

📖 Full hardware guide → Supported Hardware

💾 Flash Size Warning

⚠️ Selecting the wrong flash size during installation will cause the firmware to malfunction.

Different ESP8266 modules ship with different flash sizes. Always verify your board's flash size before flashing.

ESP8266 Modules

📖 Full guide → Flash Size Guide

🔧 Driver Not Installed?

If your computer doesn't detect the board when plugged in, you need a USB-to-Serial driver. Most boards use either CP2102 or CH340.

Serial Chip Types

📖 Full installation steps → Driver Installation

🩺 Having Issues?

Check the Troubleshooting page for solutions to the most common problems:

  • 🔴 Board not detected by computer
  • 🔴 Flash fails or disconnects
  • 🔴 Web UI won't load at 192.168.4.1
  • 🔴 Arduino IDE won't show Deauther boards
  • 🔴 Upload errors

Can't find your issue? [Open a GitHub Issue](https://github.com/h9zdev/EthiFi/issues) and the community will help.

⚖️ Disclaimer

EthiFi is developed strictly for educational and authorized security research.

  • ✅ Use on networks you own
  • ✅ Use with explicit permission from the network owner
  • ❌ Never use on public or unauthorized networks

The developer accepts no responsibility for misuse. See Disclaimer & Legal for full details.

👨‍💻 About the Developer

EthiFi is built and maintained by h9zdev.

🌐 [haybnz.web.app](https://haybnz.web.app/)  ·  🐙 [github.com/h9zdev](https://github.com/h9zdev)

📄 [License (MIT)](https://github.com/h9zdev/EthiFi/blob/main/LICENSE.md)  ·  ⭐ [Star on GitHub](https://github.com/h9zdev/EthiFi)

This wiki is maintained by the EthiFi community. Found an error? Open an [issue](https://github.com/h9zdev/EthiFi/issues) or submit a PR.

Clone this wiki locally