fail2ban-dashboard - GitLite

KO | EN

gitlite — search

#react #ai #llm #golang #go #machine-learning #rust #deep-learning #docker #awesome #cli #kubernetes #awesome-list #open-source

fail2ban-dashboard

(★ 124)

Fail2ban web dashboard written with Flask framework. (not maintained)

File Explorer

Download Latest Version (.zip)

- - banned.png
  - config.png
  - configure_filter.PNG
  - get_country1.PNG
  - home.png
- - bootstrap.min.css
  - starter-template.css
- - bootstrap.min.js
  - ie-emulation-modes-warning.js
  - ie10-viewport-bug-workaround.js
  - jquery-1.3.2.js
  - jquery.elastic.source.js
  - jquery.js
  - jquery.min.js
  - screen.css
- banned.html
- config.html
- filter.html
- index.html
.travis.yml
fail2ban_dashboard.pid
home.py
home.pyc
README.md
requirements.txt

# Installation Guide

1. Get the code

git clone https://github.com/oussemos/fail2ban-dashboard

Downloads the entire project code from GitHub to your computer.

cd fail2ban-dashboard

Moves into the project folder you just downloaded.

2. Python

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

$ pip install -r requirements.txt

Installs the Python libraries listed in requirements.txt (or similar).

$ pip install gunicorn

Installs the Python libraries listed in requirements.txt (or similar).

✅ If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

fail2ban-dashboard
==================
[![Build Status](https://travis-ci.org/oussemos/fail2ban-dashboard.svg?branch=master)](https://travis-ci.org/oussemos/fail2ban-dashboard)

Fail2ban web dashboard written with Flask framework.

PS: I've started this project in 2015 to learn Python/Flask

### Quick Start

1. Clone the repo
  ```
  $ git clone https://github.com/oussemos/fail2ban-dashboard.git
  $ cd fail2ban-dashboard
  ```

2. Initialize and activate a virtualenv:
  ```
  $ virtualenv --no-site-packages env
  $ source env/bin/activate
  ```

3. Install the dependencies:
  ```
  $ pip install -r requirements.txt
  ```

5. Run the development server:
  ```
  $ python home.py
  ```

6. Navigate to [http://localhost:5000](http://localhost:5000)

login: ouss
password: pass

### Deployment

For more stability, you can deploy the application with Gunicorn.

```
  $ pip install gunicorn
  $ gunicorn home:app -p fail2ban_dashboard.pid -b 0.0.0.0:5000 -D
  ```

### Issues

* The application is still under development, don't hesitate to give advice, open an <a href="https://github.com/oussemos/fail2ban-dashboard/issues">issue</a> or contribute.

### System

* This app was developed and tested under Debian Wheezy

### Screenshots

![Home](https://raw.githubusercontent.com/oussemos/fail2ban-dashboard/master/docs/screenshots/home.png)

![Config](https://raw.githubusercontent.com/oussemos/fail2ban-dashboard/master/docs/screenshots/config.png)

![Config filter](https://raw.githubusercontent.com/oussemos/fail2ban-dashboard/master/docs/screenshots/configure_filter.PNG)

![Banned IP](https://raw.githubusercontent.com/oussemos/fail2ban-dashboard/master/docs/screenshots/get_country1.PNG)

### Changelog

(28-10-2014) : new features

* Filters configuration
* Authentification with password

(21-09-2015)

* Fail2ban-dashboard is now compatible with init and systemd, Thanks to @<a href="https://github.com/nocternology">nocternology</a>

(30-03-2016)

* Get the country of blocked IP using this <a href="http://ip-api.com/json/">API</a>

### Bonus

(15-11-2014)

* A Docker fail2ban-dashboard preconfigured container based on Debian Wheezy
```
$ docker pull oussemos/fail2ban-dashboard
```

### Author

<a href="http://oussema.cherni.tn">Oussema Cherni</a> (@<a href="http://twitter.com/oussemos">oussemos</a> on Twitter)

### License

Open source licensed under the MIT license.