happy-ferret / notifico

My personal http://cia.vc replacement project. Now used by over 3000 projects.

Notifico!

Notifico is my personal open source (MIT) replacement to the now-defunct http://cia.vc 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.

Installation

Dependencies

• 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

Setup

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 setup.py install

Initial configuration

Copy the notifico config file to local_config.py

cp notifico/config.py local_config.py

Edit:

• 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

Starting

The following commands need to be run:

python -m notifico www         # add "--host 0.0.0.0" 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
    server_name notifico.example.com;
    root /path/to/notifico/static;

    try_files $uri @notifico;
    location @notifico {
        proxy_pass http://127.0.0.1:5000;
    }
}

NOTIFICO_ROUTE_STATIC can be set to False with this.