Skip to main content

Changelog

All notable changes to Bloqd are documented here.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]​

Added​

  • Documentation site with Docusaurus

Changed​

  • Improved Docker Hub image distribution

Fixed​

  • Multi-server ban reporting with netcat dependency
  • --status now shows custom filter files correctly
  • Filter name mismatch for custom templates
  • RHEL/CentOS installer compatibility

[1.0.0] - 2024-01-15​

Added​

  • Initial public release
  • Dashboard for centralized fail2ban management
  • Python agent for managed servers
  • Real-time ban monitoring via WebSocket
  • Centralized whitelist management
  • 24 built-in jail templates
  • AbuseIPDB integration
  • Discord webhook notifications
  • Email notifications and daily summaries
  • GitHub and Google OAuth support
  • Role-based access control (Admin, Operator, Viewer)
  • API with JWT and API key authentication
  • GeoIP lookup for banned IPs
  • Server metrics collection (CPU, memory, disk)
  • Remote command execution
  • Web terminal (Pro)
  • Port knocking (Pro)
  • SIEM integration (Pro)

Security​

  • bcrypt password hashing
  • CSRF protection
  • Rate limiting
  • Secure session management

Version History Summary​

VersionDateHighlights
1.0.02024-01-15Initial release

Upgrade Notes​

Upgrading to 1.x​

No special upgrade steps required for initial release.

Future Upgrades​

When upgrading between versions:

  1. Backup first:

    sqlite3 ./data/bloqd.db ".backup 'bloqd-backup.db'"

  2. Check changelog for breaking changes

  3. Pull and restart:

    docker compose pull
    docker compose up -d

  4. Verify:

    docker compose logs bloqd | head -50

Release Schedule​

  • Patch releases (x.x.1): As needed for bug fixes
  • Minor releases (x.1.0): Monthly with new features
  • Major releases (2.0.0): As needed for breaking changes

Getting Updates​

Docker​

# Check current version
docker compose exec bloqd node -e "console.log(require('./package.json').version)"

# Pull latest
docker compose pull
docker compose up -d

Notifications​

Contributing​

Found a bug or have a feature request?

  1. Check existing GitHub Issues
  2. Open a new issue with details
  3. PRs welcome for bug fixes

Deprecation Policy​

  • Deprecated features are announced at least one minor version in advance
  • Deprecated features show warnings in logs
  • Deprecated features are removed in the next major version