ADBHoney
github.com
What it is
ADBHoney is a free, open-source, self-hosted honeypot for observing attacks against Android Debug Bridge services exposed over TCP/IP. It is designed to catch malware sent to devices, including systems reachable on port 5555. The decoy accepts ADB connect, push, and shell operations. Activity is redirected to standard output, while uploaded files are written to disk. Its shell simulation is intentionally narrow: `adb shell ls` produces a unique response, and other commands return `command not found`. Native directory listing and interactive shell sessions are not supported. Configuration comes from `adbhoney.cfg`, placed beside `run.py` or at `/etc/adbhoney.cfg`. Deployment options described by the project are running the Python script or building and running a Docker container. The README says CPU and memory use should be fairly low. The repository identifies GPL-3.0 licensing, and huuck is identified as Gabriel Cirlig. Protocol issue reports should include a `.pcap` or exact reproduction steps.
Spec sheet
- Purpose
- ADBHoney is a low interaction honeypot designed for Android Debug Bridge over TCP/IP.Read 8 Oct 2026 · github.com
- Intended users
- The README describes the project for investigating activity against exposed Android Debug Bridge services.Read 8 Oct 2026 · github.com
- Deployment
- The project can be started with Python or run using Docker or Docker Compose.Read 8 Oct 2026 · github.com
- Support
- For issues involving protocol behavior, the maintainer asks for a `.pcap` or very exact reproduction steps.Read 4 Oct 2026 · github.com
- License
- The GitHub repository identifies the project as GPL-3.0 licensed.Read 8 Oct 2026 · github.com
- Maker
- The GitHub profile identifies huuck as Gabriel Cirlig.Read 4 Oct 2026 · github.com
- ADB commands
- It supports connecting with adb connect, uploading with adb push, and running commands with adb shell.Read 8 Oct 2026 · github.com
- Captured data
- Data is redirected to stdout and uploaded files are saved to disk.Read 4 Oct 2026 · github.com
- Configuration
- The configuration file must be beside run.py or at /etc/adbhoney.cfg.Read 8 Oct 2026 · github.com
- Issue reports
- The maintainer asks for a .pcap or very exact reproduction steps when reporting protocol issues.Read 8 Oct 2026 · github.com
- Limitations
- More advanced commands, including native directory listing and an interactive shell, are not supported.Read 8 Oct 2026 · github.com
- Logging
- Data is redirected to stdout, and files are saved to disk.Read 8 Oct 2026 · github.com
- Protocol
- It accepts ADB connect, push, and shell operations.Read 4 Oct 2026 · github.com
- Resource use
- The README says CPU and memory usage should be fairly low.Read 8 Oct 2026 · github.com
- Shell responses
- The adb shell ls command has a unique response; other commands respond with command not found unless responses are added in responses.py.Read 8 Oct 2026 · github.com
- Use case
- The project aims to catch malware pushed by attackers to devices with port 5555 exposed.Read 8 Oct 2026 · github.com
Strong points and limits
Strong points
- Free and open source under GPL-3.0
- Accepts ADB connect, push, and shell operations
- Uploaded files are saved to disk
- Supports Python or Docker deployment
- Designed for exposed Android Debug Bridge investigations
Limits
- Interactive shell sessions are unsupported
- Native directory listing is unsupported
- Most shell commands return command not found
- Configuration file must be placed at specific paths
Who it suits
ADBHoney suits security investigators examining activity against exposed Android Debug Bridge services. It is for operators wanting a narrow, self-hosted endpoint decoy rather than a full interactive ADB environment.
Verdict
ADBHoney provides a focused ADB honeypot with clear capture behavior and simple deployment routes. Its deliberately limited shell makes it an observation decoy, not a complete ADB simulator.
Where Specifiction places it
- Honeypot Software#17 of 217.1