Skip to content
Blocklister generates MikroTik Router OS compatible address-lists from commonly known Internet Block-lists.
Branch: develop
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



Blocklister generates MikroTik Router OS compatible address-lists from commonly known Internet Blocklists such as iblocklist and DShield. The lists are updated once every 2 days. Blocklister is heavily inspired by Joshaven Potter's blog post.

Currently supported lists

Here a list of currently supported lists. All of the original sources are linked here.


To install Blocklister on your machine make sure you have python 2.7 or python 3 with virtualenv installed. Follow the next few steps to get the application up and running with a dedicated user and behind an Apache Webserver.


The dependencies listed here are meant for Ubuntu 14.04.

sudo apt-get install apache2 libapache2-mod-wsgi python-virtualenv
python-dev supervisor

Setup user

In this step we are going to create an individual user for Blocklister and also create a folders for log files and for the wsgi script we are going to use later on in apache.

sudo useradd -c "Blocklister User" -d /var/www/blocklister -m blocklister
sudo install -d -m 775 -o www-data -g blocklister /var/www/blocklister/logs
sudo install -d -m 755 -o blocklister -g blocklister /var/www/blocklister/wsgi

Install application

This will get you the latest version. The package hasn't been published on pypi yet.

sudo -u blocklister -i
virtualenv env
./env/bin/pip install


The configuration file can be put in one of the following places /etc/blocklister/blocklister.conf, ~/.blocklister.conf or ~/blocklister.conf. The following options are available.

Parameter Description
store Disk location to be used for storage
update_interval Update interval for Updater Daemon (in seconds)
refresh_list Refresh lists after x days (in days)
deduplicate Summarize sequential IPs into ranges
store = /tmp
update_interval = 120
refresh_list = 2
deduplicate = true

Updater Daemon

Next we will setup the Updater daemon. We are going to use supervisor for this. In order to do this add the following configuration file to /etc/supervisor/conf.d/blocklister-updater.conf.


Next start supervisorctl and reread the configuration file and fire up blocklister-updater.

sudo supervisorctl
supervisor> reread
blocklister-updater: available
supervisor> update
blocklister-updater: added process group
supervisor> status
blocklister-updater              RUNNING    pid 9535, uptime 0:00:03

WSGI Script

Next we are going to place the wsgi script into /var/www/blocklister/wsgi/blocklister.wsgi. This file will be needed in the next step to get apache up and running.

activate_this = "/var/www/blocklister/env/bin/"
execfile(activate_this, dict(__file__=activate_this))

from blocklister.main import app as application

Apache Config

Now all that's left to do is to get apache up and running. First make sure that you have mod-wsgi enabled.

a2enmod wsgi
service apache2 reload

Now put the following content into /etc/apache2/sites-available/blocklister.conf.

<VirtualHost *:80>
    ServerAlias blocklister

    WSGIDaemonProcess blocklister user=blocklister group=blocklister threads=5
    WSGIScriptAlias / /var/www/blocklister/wsgi/blocklister.wsgi

    <Directory /var/www/blocklister>
        WSGIProcessGroup blocklister
        WSGIApplicationGroup %{GLOBAL}
        Order deny,allow
        Allow from all

    # Log Files
    LogLevel warn
    CustomLog /var/www/blocklister/logs/access.log combined
    ErrorLog  /var/www/blocklister/logs/error.log

Next enable the site and reload apache, and the site should be up and running.

sudo a2ensite blocklister
sudo service apache2 reload

Issues or Requests

For issues and requests please use the issue tracker on github or email me.

You can’t perform that action at this time.