Server Management

The Servers page lets you manage all connected fail2ban instances.

Server List

The server list shows all registered servers with:

Column	Description
Name	Server hostname or custom name
Status	Online (green) or Offline (red)
Jails	Number of enabled jails
Bans (24h)	Bans in the last 24 hours
Last Seen	Time since last heartbeat
Actions	Quick action buttons

Filtering

• Search: Filter by server name
• Status: Show all, online only, or offline only

Adding a Server

1. Click Add Server button
2. Enter server details:
   • Name: Friendly name for the server
   • Jails: Select which jails to enable
3. Configure jail settings (optional):
   • Custom log paths
   • Ban time, find time, max retry
4. Click Generate Install Command
5. Copy and run the command on your target server

See Add Your First Server for detailed instructions.

Server Detail View

Click on a server to see its detail page:

Overview Tab

• Server information (hostname, OS, IP)
• Agent version
• fail2ban version
• Uptime

Metrics Tab

System resource usage:

• CPU usage (percentage)
• Memory usage (percentage)
• Disk usage (percentage)
• Load averages (1, 5, 15 min)

Jails Tab

List of all jails with status:

• Enabled/disabled toggle
• Current ban count
• Filter information

Bans Tab

Recent bans for this server:

• IP address
• Jail name
• Timestamp
• Actions (unban, WHOIS)

Commands Tab

Execute remote commands:

• Reload fail2ban
• Enable/disable jails
• Ban/unban IPs
• Force whitelist sync

Terminal Tab (Personal+)

WebSocket terminal for direct server access:

• Execute commands
• View output in real-time
• Session history

Server Actions

Sync Whitelist

Force an immediate whitelist sync:

1. Click server menu (⋮)
2. Select Sync Whitelist
3. Wait for confirmation

Reload fail2ban

Reload fail2ban configuration:

1. Click server menu (⋮)
2. Select Reload fail2ban
3. Check command result

Update Config

Modify server configuration:

1. Click Edit button
2. Change jail settings
3. Add or remove jails
4. Click Save

Agent will apply changes on next sync.

Delete Server

Remove a server from Bloqd:

1. Click server menu (⋮)
2. Select Delete Server
3. Confirm deletion

warning

Deleting a server removes all its ban history and logs from Bloqd. The agent on the server remains installed but won't sync anymore.

Bulk Operations (Pro)

Select multiple servers for bulk actions:

1. Check boxes next to servers
2. Choose action from toolbar:
   • Sync whitelist
   • Reload fail2ban
   • Enable/disable jail
3. Confirm action

Server Health

Monitor server health status:

Indicator	Meaning
🟢 Green	All systems normal
🟡 Yellow	Warning (high resource usage)
🔴 Red	Critical or offline

Health checks include:

• fail2ban running
• Disk space > 10%
• Memory usage < 90%
• Agent connected