Installation Guide
Get TarPit.pro running on your server in under 60 seconds.
Quick Install (Recommended)
The fastest way to get started. Run this single command:
curl -fsSL https://get.tarpit.pro | sudo bashThis will download the latest release, install it to /usr/local/bin, and set up the system service.
What Gets Installed
/usr/local/bin/tarpit-proMain binary
~/.tarpit-pro/config.yamlConfiguration file
systemd/launchd serviceSystem service (auto-start on boot)
iptables rulesAutomatic IP banning integration
Manual Installation
If you prefer to install manually or the script doesn't work for your system:
1. Download the Binary
Download the appropriate binary for your system from the releases page:
# Linux (AMD64)
curl -L https://releases.tarpit.pro/tarpit-pro-linux-amd64 -o tarpit-pro
# Linux (ARM64)
curl -L https://releases.tarpit.pro/tarpit-pro-linux-arm64 -o tarpit-pro
# macOS (Intel)
curl -L https://releases.tarpit.pro/tarpit-pro-darwin-amd64 -o tarpit-pro
# macOS (Apple Silicon)
curl -L https://releases.tarpit.pro/tarpit-pro-darwin-arm64 -o tarpit-pro2. Make it Executable
chmod +x tarpit-pro
sudo mv tarpit-pro /usr/local/bin/3. Install as Service (Optional)
sudo tarpit-pro installVerify Installation
Check that TarPit.pro is installed correctly:
tarpit-pro versionYou should see output like:
TarPit.pro v1.0.0
Built: 2024-02-11
Go: go1.21.6
Platform: linux/amd64Activate Your License
All users need a license key to run TarPit.pro, including the free tier. Register at tarpit.pro/register to get your key, then activate it:
tarpit-pro activate YOUR_KEYStart the Honeypot
Option A: Foreground (Testing)
Start in foreground mode to see logs in real-time:
sudo tarpit-pro start -fOption B: System Service (Production)
Start via the system service for production use:
sudo tarpit-pro service startDefault Honeypot Ports
TarPit.pro listens on these ports by default:
| Port | Service | Banner |
|---|---|---|
| 21 | FTP | vsFTPd 3.0.5 |
| 22 | SSH | OpenSSH 8.9p1 |
| 23 | Telnet | Login prompt |
| 3306 | MySQL | MySQL 8.0.35 |
| 5432 | PostgreSQL | Auth request |
| 6379 | Redis | NOAUTH required |
See Configuration to customize ports.
System Requirements
Minimum
- 64-bit Linux, macOS, or Windows
- 1 CPU core
- 128 MB RAM
- 10 MB disk space
Recommended
- Ubuntu 22.04+ / Debian 12+
- 2+ CPU cores
- 256 MB RAM
- iptables available
Troubleshooting
Port already in use
If a port is already bound by another service, TarPit.pro will skip it. Remove conflicting ports:
tarpit-pro port remove 22 # Skip SSH if you have real SSH runningPermission denied
Ports below 1024 require root privileges. Run with sudo:
sudo tarpit-pro start