https://github.com/hhftechnology/crowdsec_manager

A web-based and mobile management interface and dashboard for CrowdSec security stack with Pangolin integration and multi proxy support- caddy, NPM, etc. This project replaces the bash script with a modern, user-friendly ShadcnUI built with Go and React.
https://github.com/hhftechnology/crowdsec_manager

android-application crowdsec crowdsec-dashboard crowdsec-manager crowdsec-mobile crowdsec-ui ios-app pangolin traefik

Last synced: 4 days ago
JSON representation

A web-based and mobile management interface and dashboard for CrowdSec security stack with Pangolin integration and multi proxy support- caddy, NPM, etc. This project replaces the bash script with a modern, user-friendly ShadcnUI built with Go and React.

• Host: GitHub
• URL: https://github.com/hhftechnology/crowdsec_manager
• Owner: hhftechnology
• Created: 2025-03-05T04:07:50.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2026-05-15T04:22:37.000Z (30 days ago)
• Last Synced: 2026-05-15T06:36:22.176Z (30 days ago)
• Topics: android-application, crowdsec, crowdsec-dashboard, crowdsec-manager, crowdsec-mobile, crowdsec-ui, ios-app, pangolin, traefik
• Language: TypeScript
• Homepage: https://crowdsec-manager.hhf.technology/
• Size: 34.7 MB
• Stars: 468
• Watchers: 4
• Forks: 9
• Open Issues: 9
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-crowdsec - crowdsec_manager - Full-featured management dashboard built with Go and React, with Pangolin integration. (Web UIs & Management / Other Bouncers)

README

          


  
CrowdSec Manager


[![Docker](https://img.shields.io/docker/pulls/hhftechnology/crowdsec-manager?style=flat-square)](https://hub.docker.com/r/hhftechnology/crowdsec-manager)

![Stars](https://img.shields.io/github/stars/hhftechnology/crowdsec_manager?style=flat-square)

[![Discord](https://img.shields.io/discord/994247717368909884?logo=discord&style=flat-square)](https://discord.gg/HDCt9MjyMJ)

![License](https://img.shields.io/badge/license-MIT-blue.svg)

![Status](https://img.shields.io/badge/status-stable-22c55e.svg)



A web-based management interface for CrowdSec — decisions, alerts, allowlists, scenarios, hub, logs, backups, and Traefik integration.

## Mobile App



  

    

      


      Coming Soon

    

    

      


      For Pangolin Users

    

    

      


      For Multi Proxy(independent)

    

  

 



## Mobile Screenshots

  

    

      


      Connection Setup

    

    

      


      Dashboard Overview

    

    

      


      Security IP Check

    

  

  

    

      


      Security Alerts List

    

    

      


      Security Metrics

    

    

      


      Logs Viewer

    

  

  

    

      


      Management Home

    

    

      


      Allowlists Management

    

    

      


      Hub Management

    

  

  

    

      


      Scenarios Management

    

    

      


      Container Controls

    

    

      


      Terminal Shell

    

  

Native iOS and Android app. Supports **Pangolin** (token-based remote access) and **Basis** (direct URL) connection modes.

## Release

- Version: `2.4.0`

- Pangolin image: `hhftechnology/crowdsec-manager:latest` — full stack with Traefik, Pangolin, Gerbil

- Independent image: `hhftechnology/crowdsec-manager:independent` — CrowdSec only, no Traefik

- Image size (linux/amd64): 44MB

## Quick Start

### Pangolin (full stack)

```bash

  # Your CrowdSec Manager

  crowdsec-manager:

    image: hhftechnology/crowdsec-manager:latest

    container_name: crowdsec-manager

    restart: unless-stopped

    environment:

      - PORT=8080

      - ENVIRONMENT=production

      - TRAEFIK_DYNAMIC_CONFIG=/etc/traefik/dynamic_config.yml

      - TRAEFIK_CONTAINER_NAME=traefik

      - TRAEFIK_STATIC_CONFIG=/etc/traefik/traefik_config.yml

      - CROWDSEC_METRICS_URL=http://crowdsec:6060/metrics

      - ALERT_LIST_LIMIT=5000

    volumes:

      - /var/run/docker.sock:/var/run/docker.sock

      - /root/config:/app/config # pangolin config folder

      - /root/docker-compose.yml:/app/docker-compose.yml # pangolin compose yml

      - ./crowdsec-manager/backups:/app/backups

      - ./crowdsec-manager/data:/app/data

      # Optional GeoIP database for enriched dashboard location data

      - ./geoip/GeoLite2-City.mmdb:/app/geoip/GeoLite2-City.mmdb:ro

    depends_on:

      crowdsec:

        condition: service_healthy

docker compose up -d

```

### Independent (CrowdSec only)

```bash

mkdir -p ./config/crowdsec ./logs/app ./data

```

```yaml

services:

  crowdsec-manager:

    image: hhftechnology/crowdsec-manager:independent

    container_name: crowdsec-manager

    restart: unless-stopped

    ports:

      - "8080:8080"

    environment:

      - PORT=8080

      - ENVIRONMENT=production

      - CONFIG_DIR=/app/config

      - DATABASE_PATH=/app/data/settings.db

      - INCLUDE_CROWDSEC=true

    volumes:

      - /var/run/docker.sock:/var/run/docker.sock

      - ./config:/app/config

      - ./logs/app:/app/logs

      - ./data:/app/data

    networks:

      - crowdsec-network

    depends_on:

      - crowdsec

  crowdsec:

    image: crowdsecurity/crowdsec:latest

    container_name: crowdsec

    environment:

      - COLLECTIONS=crowdsecurity/linux

    volumes:

      - ./config/crowdsec/acquis.yaml:/etc/crowdsec/acquis.yaml:ro

      - crowdsec-db:/var/lib/crowdsec/data/

      - crowdsec-config:/etc/crowdsec/

    networks:

      - crowdsec-network

networks:

  crowdsec-network:

    driver: bridge

volumes:

  crowdsec-db:

  crowdsec-config:

```

```bash

docker compose up -d

curl http://localhost:8080/api/health/stack

```

## Screenshots

































































## Documentation

Full installation guide, configuration reference, mobile app setup, and API docs:

[crowdsec-manager.hhf.technology](https://crowdsec-manager.hhf.technology)

## License

MIT — see [LICENSE](LICENSE).

## Support

- [GitHub Issues](https://github.com/hhftechnology/crowdsec_manager/issues)

- [Discord](https://discord.gg/HDCt9MjyMJ)