Skip to content
CrowdSec Local Dashboard

Changelog

All versionsAll versions forwardView on GitHub

Version v0.3.0-beta

v0.3.0-beta

This release contains breaking changes. Please read the full notes before updating.

This release brings alert extraction and OIDC single sign-on to the dashboard, along with various bug fixes and internal refactors.

Highlights

Alert Extraction

Decisions now show the alerts that triggered them. Expanded rows display details like scanned ports and requested HTTP paths, giving you immediate context without needing to dig through logs.

Currently supported alert types:

  • pf_drop / pf_pass (OPNsense)
  • http_access-log (Traefik)

If your alerts appear empty, please open an issue with a sample event and I’ll add parsing support.

OIDC / SSO Login

You can now sign in with any standards-compliant OIDC provider (Authentik, Keycloak, Okta, etc.). Username/password login remains available as a fallback. See the SSO setup guide in the README for configuration details.

Bug Fixes & Improvements

  • Fixed query invalidation issues that caused stale data in tables
  • Add loading state and alerts in multiple places for better UX
  • Reduced time taken to delete decisions significantly
  • Various internal refactors for reliability

⚠️ Breaking Changes

This release includes two breaking changes that require manual action.

1. Repository Rename

The project has been renamed to crowdsec-local-dashboard. Update your Compose file to pull the new image:

image: ghcr.io/ollioddi/crowdsec-local-dashboard:v0.3.0-beta

Consider pinning to a tagged version (e.g. v0.3.0-beta) instead of latest while this project is in beta. Future breaking changes are possible until a stable release.

2. Database Reset Required

The database schema has changed significantly and there is no automatic migration path. You must delete your existing database volume before upgrading.

To do this:

  1. Stop the dashboard:
    Terminal window
    docker compose down
  2. Find your volume name:
    Terminal window
    docker volume ls
  3. Remove it:
    Terminal window
    docker volume rm <volume-name>
  4. Start the dashboard — a fresh database will be created automatically:
    Terminal window
    docker compose up -d

Note: This will delete all local decision history and user accounts. You will be prompted to create a new admin account on first launch. Active decisions will be re-synced from your CrowdSec LAPI on startup.

What’s Changed

  • Feat: Alerts by @ollioddi in #2
  • Fix by @ollioddi in #3
  • Fix query invalidation issues (stale data) by @ollioddi in #4
  • Enhance alerts by @ollioddi in #5
  • Feat: OIDC by @ollioddi in #6

Full Changelog: v0.2.0-beta → v0.3.0-beta