Introduction to Bloqd

Bloqd is a centralized fail2ban management platform that provides enterprise-grade security orchestration across multiple servers. Monitor, manage, and report IP bans from a single dashboard.

The Problem

Managing fail2ban across multiple servers creates challenges:

• Scattered configurations - Each server has its own jails, filters, and whitelists
• No unified visibility - Can't see which IPs are being banned across your infrastructure
• Manual synchronization - Whitelisting an IP means updating every server manually
• Limited automation - No central way to report attackers or get notified

The Solution

Bloqd provides a central management layer for all your fail2ban instances:

┌─────────────────────────────────────────────────────────────┐
│                     Bloqd Dashboard                          │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐        │
│  │ Servers │  │  Bans   │  │Whitelist│  │Templates│        │
│  └─────────┘  └─────────┘  └─────────┘  └─────────┘        │
└──────────────────────┬──────────────────────────────────────┘
                       │ API
        ┌──────────────┼──────────────┐
        ▼              ▼              ▼
   ┌─────────┐    ┌─────────┐    ┌─────────┐
   │ Server 1│    │ Server 2│    │ Server 3│
   │  Agent  │    │  Agent  │    │  Agent  │
   │fail2ban │    │fail2ban │    │fail2ban │
   └─────────┘    └─────────┘    └─────────┘

Key Features

Multi-Server Management

Connect unlimited servers (with Pro license) and manage them all from one dashboard. Each server runs a lightweight Python agent that communicates with the central Bloqd server.

Centralized Whitelist

Add an IP to the whitelist once, and it automatically syncs to all connected servers. No more SSH-ing into each box to update configurations.

Real-Time Ban Monitoring

See bans as they happen with live WebSocket updates. Search ban history, view geographic distribution, and identify attack patterns.

20+ Jail Templates

Pre-configured templates for common services:

• SSH - sshd
• Web Servers - nginx, Apache
• Mail - Postfix, Dovecot, Mailcow
• Databases - MySQL, MongoDB
• Web Apps - WordPress, Nextcloud, Grafana
• Virtualization - Proxmox

Integrations

• AbuseIPDB - Automatically report malicious IPs
• Discord - Real-time ban notifications
• Email - Daily summary reports
• OAuth - GitHub and Google SSO

Advanced Features

• Remote Commands - Ban/unban IPs, reload jails remotely
• Terminal Access - WebSocket terminal for direct server access
• Port Knocking - Secure port access with knock sequences (Pro)
• SIEM Integration - Security monitoring and vulnerability tracking (Pro)

License Tiers

Feature	Free	Personal	Pro
Servers	1	5	Unlimited
Health Monitoring	-	✓	✓
Custom Jails	-	✓	✓
Remote Commands	-	✓	✓
Terminal Access	-	✓	✓
AbuseIPDB Reporting	-	✓	✓
Port Knocking	-	-	✓
SIEM Monitoring	-	-	✓
Bulk Operations	-	-	✓

Technology Stack

Server:

• Node.js + Express
• SQLite database
• WebSocket for real-time updates

Agent:

• Python 3.10+
• Modular architecture
• Systemd integration

Frontend:

• React + Vite
• Tailwind CSS

Next Steps

Ready to get started?

1. Quick Start Guide - Deploy Bloqd in 5 minutes
2. Docker Installation - Detailed setup guide
3. Add Your First Server - Connect a server to Bloqd