Skip to main content

Settings

The Settings page lets you configure Bloqd's behavior and integrations.

General Settings​

System Information​

View system details:

  • Bloqd version
  • Database size
  • Uptime
  • License status

Jail Defaults​

Set default values for new jails:

SettingDescriptionDefault
Max RetryFailed attempts before ban5
Find TimeWindow for counting attempts (seconds)600
Ban TimeBan duration (seconds)3600

These defaults apply when adding new jails without specifying custom values.

Discord Integration​

Connect Bloqd to Discord for real-time notifications.

Setup​

  1. Create a Discord webhook:
    • Server Settings → Integrations → Webhooks
    • New Webhook → Copy URL
  2. In Bloqd Settings:
    • Enable Discord
    • Paste webhook URL
    • Configure notifications
    • Test connection

Notification Options​

OptionDescription
Notify BansSend message for each ban
Notify SyncsSend message for sync events
Notify ErrorsSend message for errors
Daily SummarySend aggregated daily report
Summary HourHour (UTC) for daily summary

Message Customization​

Notifications include:

  • IP address with country flag
  • Jail name
  • Server name
  • Timestamp
  • Log excerpt (if available)

Color coding:

  • 🔴 Red: Ban notifications
  • 🟢 Green: Successful syncs
  • 🟠 Orange: Warnings/failures
  • 🟣 Purple: Daily summaries

Email / SMTP​

Configure email notifications.

SMTP Setup​

SettingDescription
HostSMTP server hostname
PortSMTP port (465, 587, 25)
UsernameSMTP username
PasswordSMTP password
From AddressSender email address
TLSEnable TLS encryption

Test Connection​

  1. Enter SMTP settings
  2. Click Test Connection
  3. Enter test recipient
  4. Verify email received

Email Notifications​

NotificationDescription
Daily SummaryDaily ban report
Alert EmailsCritical alerts

AbuseIPDB​

Automatically report malicious IPs.

Setup​

  1. Get API key from abuseipdb.com
  2. Enable AbuseIPDB in settings
  3. Enter API key
  4. Set rate limit

Configuration​

SettingDescriptionDefault
EnabledEnable automatic reportingOff
API KeyYour AbuseIPDB API key-
Rate LimitMax reports per day1000

How It Works​

  1. Ban received from agent
  2. Bloqd maps jail to AbuseIPDB category
  3. Checks if already reported (15-min window)
  4. Submits report with IP and category
  5. Stores record to prevent duplicates

Category Mapping​

JailAbuseIPDB Category
sshd22 (SSH)
postfix11 (Email Spam)
apache-auth21 (Web App Attack)
wordpress21 (Web App Attack)

API Keys​

Manage API keys for programmatic access.

View Keys​

List shows:

  • Key name
  • Permission level
  • Created date
  • Last used
  • Bound server (if any)

Create Key​

  1. Click Create Key
  2. Enter name
  3. Select permission level:
    • Read: View only
    • Write: View + modify
    • Admin: Full access
  4. Optionally bind to server
  5. Click Create
  6. Copy the key immediately (shown once)

Delete Key​

  1. Find key in list
  2. Click delete icon
  3. Confirm deletion
warning

Deleting a key immediately revokes access. Agents using that key will stop working.

Users & Roles​

Manage user accounts and permissions.

Users​

ActionDescription
Add UserCreate new user account
Edit UserChange name, email, role
Reset PasswordAdmin password reset
Delete UserRemove user account

Roles​

Default roles:

  • Admin: Full access
  • Operator: Manage servers, no settings
  • Viewer: Read-only access

Create custom roles with specific permissions.

MFA​

Enable two-factor authentication:

  1. Go to Profile
  2. Click Enable MFA
  3. Scan QR code with authenticator app
  4. Enter verification code
  5. Save backup codes

License​

Manage your Bloqd license.

View License​

  • Current tier
  • Expiration date
  • Server limit
  • Feature availability

Activate License​

  1. Enter license key
  2. Click Activate
  3. Features unlock immediately

Deactivate License​

Remove license from this instance (to transfer to another).

Data Management​

Cleanup Settings​

Configure automatic data cleanup:

SettingDescriptionDefault
Ban RetentionDays to keep ban history90
Log RetentionDays to keep sync logs30
Metrics RetentionDays to keep metrics7

Manual Cleanup​

Trigger immediate cleanup:

  1. Go to Data Management
  2. Select what to clean:
    • Old bans
    • Sync logs
    • Command logs
    • Metrics
  3. Click Clean Now

Cache Management​

Clear cached data:

  • GeoIP cache
  • AbuseIPDB cache
  • Session cache