Skip to content
 
 

Repository files navigation

What is Portsentry?

Portsentry monitors network traffic to detect and respond to port scans and probing attempts in real-time.

For a more detailed introduction, review the HOWTO-Use-Cases documentation

Quickstart

Docker

docker run -d --network=host --name portsentry portsentry/portsentry:latest

More docker configuration options available in the HOWTO-Docker.md documentation

Debian 13 (trixie)

sudo apt install curl gpg
echo 'deb https://download.opensuse.org/repositories/home:/portsentry/Debian_13/ /' | sudo tee /etc/apt/sources.list.d/portsentry.list
curl -fsSL https://download.opensuse.org/repositories/home:/portsentry/Debian_13//Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/portsentry.gpg > /dev/null
sudo apt update
sudo apt install portsentry

Debian 14 and later

sudo apt install portsentry

Ubuntu 24.04, 25.04, 25.10

sudo apt install curl gpg
echo 'deb https://download.opensuse.org/repositories/home:/portsentry/xUbuntu_24.04/ /' | sudo tee /etc/apt/sources.list.d/portsentry.list
curl -fsSL https://download.opensuse.org/repositories/home:/portsentry/xUbuntu_24.04/Release.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/portsentry.gpg > /dev/null
sudo apt update
sudo apt install portsentry

Ubuntu 26.04 and later

sudo apt install portsentry

Fedora 42

dnf config-manager addrepo --from-repofile=https://download.opensuse.org/repositories/home:/portsentry/Fedora_42/home:portsentry.repo
dnf install portsentry
sudo systemctl enable portsentry
sudo systemctl start portsentry

Fedora 43 and later

dnf install portsentry
sudo systemctl start portsentry

Arch Linux

sudo pacman -Sy curl gnupg
curl -fsSL https://download.opensuse.org/repositories/home:/portsentry/Arch/x86_64/home_portsentry_Arch.key -o /tmp/portsentry.key
sudo pacman-key --add /tmp/portsentry.key
KEYID=$(gpg --show-keys /tmp/portsentry.key | grep -A1 "^pub" | tail -n 1 | sed 's/\s*//')
sudo pacman-key --lsign-key "$KEYID"
sudo cat <<EOF >>/etc/pacman.conf
[home_portsentry_Arch]
SigLevel = Required
Server = https://download.opensuse.org/repositories/home:/portsentry/Arch/\$arch/
EOF
sudo pacman -Sy portsentry
sudo systemctl enable portsentry
sudo systemctl start portsentry

openSUSE 16

sudo zypper addrepo https://download.opensuse.org/repositories/home:/portsentry/16.0/home:portsentry.repo
sudo zypper refresh
sudo zypper install portsentry
sudo systemctl enable portsentry
sudo systemctl start portsentry

openSUSE Tumbleweed

sudo zypper addrepo https://download.opensuse.org/repositories/home:/portsentry/openSUSE_Tumbleweed/home:portsentry.repo
sudo zypper refresh
sudo zypper install portsentry
sudo systemctl enable portsentry
sudo systemctl start portsentry

openSUSE Slowroll

sudo zypper addrepo https://download.opensuse.org/repositories/home:/portsentry/openSUSE_Slowroll/home:portsentry.repo
sudo zypper refresh
sudo zypper install portsentry
sudo systemctl enable portsentry
sudo systemctl start portsentry

Other Linux distributions

Download the portsentry tar archive from the Releases page and extract the tarball in the root directory:

sudo tar --strip-components=1 -C / -xvf portsentry-*.tar.xz

*BSD

OpenBSD, NetBSD and FreeBSD are supported but must currently be compiled manually, see below

Compiling the Source Code

Detailed compilation instructions can be found on the HOWTO-Compile page.

Configuration and setup

The HOWTO-Use-Cases documentation provides an overview of how portsentry can be used

The HOWTO-Use documentation provides detailed installation and usage instructions

The Manual provides details around how Portsentry works and can be configured on the command line

The Portsentry Configuration reference provides details on how to configure Portsentry

The Logfile reference explains how log entries from Portsentry should be interpreted.

Documentation

All documentation for portsentry is indexed in the docs/README.md.

Support

Please use the Discussions Forums for any support questions or feedback

Links

Website: https://portsentry.xyz

Github: https://github.com/portsentry/portsentry

Docker Hub: https://hub.docker.com/r/portsentry/portsentry

About

Portsentry is a tool to detect and respond to port scans against a target host in real-time.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages