Skip to content

oweitman/fail2bancontrol

Repository files navigation

Fail2ban Web Control

GitHub Workflow Status Github Issues Github Pull Requests
Arch Docker Image Size (tag) Docker Pulls Docker Stars
Source GitHub Release GitHub forks GitHub stars GitHub License

Introduction

Fail2ban Web Control is a lightweight web-based control panel for managing Fail2ban.

It allows you to:

  • View global Fail2ban status
  • Inspect jails and their metrics
  • Ban and unban IP addresses
  • Control Fail2ban server actions

GitHub Workflow Status

The application communicates directly with the Fail2ban UNIX socket.


Installation

Choose one of the following:


Features

Jail Overview

  • Current and total failed attempts
  • Current and total banned IPs
  • List of monitored log files
  • Ban / unban IPs
  • Extra jail parameters (bantime, findtime, etc.)

Log File Access

If log files are mounted into the container, they can be viewed and monitored.


API

Full API documentation:

πŸ‘‰ API β†’ see


Notes & Troubleshooting

Permission issues

If you see:

Permission denied

Ensure the process/container has access to the Fail2ban socket.


Socket verification

docker exec -it fail2bancontrol ls -l /var/run/fail2ban

Port behavior

  • Internal: 9000
  • External: defined via Docker (9191:9000 in examples)

Changelog

v1.9.2 β€” 2026-04-04

  • restore old changelog
  • insert screenshot
  • no functional changes

v1.9.1 β€” 2026-04-04

  • rework readme
  • add documentation local install without docker
  • no functional changes

v1.9.0 β€” 2025-11-10

  • optimize overview requests
  • add short time caching for some values
  • more error details in api responses
  • add jail extra infos in frontend and api
  • little css improvement

v1.8.0 β€” 2025-09-03

  • add more api endpoints
  • add server control buttons start, stop, restart, reload
  • change theme switch button
  • add server version
  • add dbfile location
  • add log level slider
  • add dbmaxmatches
  • add dbpurgeage
  • add eslint
  • fix eslint errors
  • improve refresh between overview and jails
  • improve design
  • add testscript for banned ips
  • add some more documentations

v1.5.1 β€” 2025-08-28

  • recreate frontend sources
  • improve release script

v1.5.0 – 2025-08-28

  • add version
  • add workflow actions for release and version

Version 1.4.0

  • improve backend logic fΓΌr prod and dev
  • add footer with links

Version 1.3.0

  • automate docker push

Version 1.2.0

  • Feature FileView

Version 1.1.0

  • Move gui to mui/react

Version 1.0.0

  • Initial release

About

This project provides a lightweight web-based control panel for managing Fail2ban.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors