Skip to content
My personal replacement project. Now used by over 3000 projects.
Branch: master
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.


Notifico is my personal open source (MIT) replacement to the now-defunct service with my own little spin on things.

Please note that this is extremely alpha software and likely has many flaws and potential exploits. That said, it's safe to run your own copy with registrations disabled.



  • python 2.x / virtualenv / pip
  • redis
  • Either:
    • Install python C headers and a working C compiler and let pip take care of it.
    • Install the following python libraries through your package manager: gevent sqlalchemy pycrypto markupsafe celery

For debian based systems, that would be:

apt-get install python python-dev python-pip python-virtualenv redis-server
apt-get install python-gevent python-sqlalchemy python-crypto python-markupsafe python-celery

For RHEL/CentOS:

yum install epel-release
yum install redis git python python-devel python-pip python-virtualenv
yum install python-gevent python-sqlalchemy python-markupsafe python-celery python-crypto2.6


First, create a virtualenv:

virtualenv2 --system-site-packages notifico-env
# or "virtualenv" instead of "virtualenv2"

source ./notifico-env/bin/activate

The virtualenv step can be skipped to install all dependencies globally. However, this is not recommended, and requires running the following step as root.

Next, install notifico and all its dependencies.

python install

Initial configuration

Copy the notifico config file to

cp notifico/


  • SECRET_KEY - set it to some random long string (you can generate one with, e.g. openssl rand -base64 48)
  • Optional: NOTIFICO_NEW_USERS should be set to False for private servers after having registered one user through the web UI.
  • Optional: NOTIFICO_PASSWORD_RESET, requires configuring Flask-Mail (MAIL_SERVER, MAIL_PORT, etc)

Initialize the database:

python -m notifico init


The following commands need to be run:

python -m notifico www         # add "--host" to make it public
python -m notifico bots
python -m notifico worker      # not needed if password resets are disabled

You can do this in three separate screen/tmux windows, or use the provided supervisor config in misc/deploy/supervisord.conf.

You can now go to your-server:5000 with a web browser, register and set up webhooks if you wish, or do the next step to access through port 80.

Nginx proxying

Use the following nginx config to have notifico in a subdomain and have it handle static files:

server {
    # change these two
    root /path/to/notifico/static;

    try_files $uri @notifico;
    location @notifico {

NOTIFICO_ROUTE_STATIC can be set to False with this.

You can’t perform that action at this time.