Docs/Installation

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 bash

This will download the latest release, install it to /usr/local/bin, and set up the system service.

What Gets Installed

/usr/local/bin/tarpit-pro

Main binary

~/.tarpit-pro/config.yaml

Configuration file

systemd/launchd service

System service (auto-start on boot)

iptables rules

Automatic 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-pro

2. Make it Executable

chmod +x tarpit-pro
sudo mv tarpit-pro /usr/local/bin/

3. Install as Service (Optional)

sudo tarpit-pro install

Verify Installation

Check that TarPit.pro is installed correctly:

tarpit-pro version

You should see output like:

TarPit.pro v1.0.0
Built: 2024-02-11
Go: go1.21.6
Platform: linux/amd64

Activate 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_KEY

Start the Honeypot

Option A: Foreground (Testing)

Start in foreground mode to see logs in real-time:

sudo tarpit-pro start -f

Option B: System Service (Production)

Start via the system service for production use:

sudo tarpit-pro service start

Default Honeypot Ports

TarPit.pro listens on these ports by default:

PortServiceBanner
21FTPvsFTPd 3.0.5
22SSHOpenSSH 8.9p1
23TelnetLogin prompt
3306MySQLMySQL 8.0.35
5432PostgreSQLAuth request
6379RedisNOAUTH 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 running

Permission denied

Ports below 1024 require root privileges. Run with sudo:

sudo tarpit-pro start