webyhomelab/firewalld-gui repository overview

⁠🛡️ Firewalld-GUI (Weby Homelab)

Modern, fast, and aesthetic network security management for Linux.

Firewalld-GUI is a professional web-based control panel for managing firewalld and Fail2Ban. It transforms complex CLI commands into an intuitive dashboard with real-time analytics.

⁠🐳 Quick Start (Docker)

The fastest way to run Firewalld-GUI is using the official Docker image:

docker run -d \
  --name firewalld-gui \
  --network host \
  --privileged \
  -v /etc/firewalld:/etc/firewalld \
  -v /var/run/dbus:/var/run/dbus \
  -v /var/run/fail2ban/fail2ban.sock:/var/run/fail2ban/fail2ban.sock \
  -v /var/log:/var/log:ro \
  -v ./data:/app/data \
  webyhomelab/firewalld-gui:latest

Or via docker-compose.yml:

services:
  firewalld-gui:
    image: webyhomelab/firewalld-gui:latest
    container_name: firewalld-gui
    network_mode: host
    privileged: true
    volumes:
      - /etc/firewalld:/etc/firewalld
      - /var/run/dbus:/var/run/dbus
      - /var/run/fail2ban/fail2ban.sock:/var/run/fail2ban/fail2ban.sock
      - /var/log:/var/log:ro
      - ./data:/app/data
    restart: always

The panel will be available on port 8649.

⁠🚀 Key Features

• Service Architect: Create custom service definitions by grouping ports and protocols.
• Object Lifecycle: Manage Zones, Policies, and IPsets via a modern UI.
• Threat Intelligence: Geo-IP integration to track attack origins in real-time.
• Anomaly Detection: Automatic Telegram alerts for traffic spikes.
• Safety First: Automatic snapshots created before every configuration change.

⁠🏗️ Architecture

The project is built as an All-in-One Docker Image:

1. Frontend (React): Responsive SPA interface built and embedded into the backend.
2. Backend (FastAPI): Asynchronous API serving requests and static frontend files.
3. OS Integration: Direct interaction with firewalld via DBus.

Built in Ukraine under air raid sirens & blackouts ⚡
© 2026 Weby Homelab