Système d'information du FAI Illyse

CapsLock 7ecad34847 otp : settings cleanup 4 years ago
coin 7ecad34847 otp : settings cleanup 4 years ago
contrib 4389dc53ea Ajout du path pour python et de la suppression du pid après le kill 4 years ago
.gitignore 5a71dd3438 Make use of django-sendfile to have the possibility to make use of web serveur to send a private file to a client. 4 years ago 3171b18735 Hint on debuggin gunicorn 4 years ago 25ea388017 Quick documentation about the Sites application 4 years ago 8efe3fd1fb Add some default values 5 years ago
requirements.txt b156ef8638 Strong Authentication using "django-otp". Support of yubikeys using 4 years ago

The COIN project

Coin is Illyse's Information System, designed to manage both members and Internet accesses, such as through DSL, VPN, wireless…

It is written in Django, and makes an heavy use of LDAP (for authentication, and to store configuration information).

It features a generic configuration interface, which allows to implement custom backends for different technologies. Currently implemented is a LDAP-based backend for OpenVPN.

Coin currently only works with python2, because python-ldap is (as of 2013) not compatible with python3.

The project page (issue, wiki, etc) is here:

A mirror of the code is available at:


Get yourself a virtualenv. On Debian, install python-virtualenv. On Archlinux, the package is called python2-virtualenv, and you must replace the virtualenv command with virtualenv2 in the following.

To create the virtualenv (the first time):

virtualenv ~/tmp/venv-illyse

To activate the virtualenv (you need to do this each time you work on the project):

. ~/tmp/venv-illyse/bin/activate

Install dependencies. On Debian, you will probably need the python-dev, python-pip, libldap-dev, libpq-dev and libsasl2-dev packages.

sudo apt-get install python-dev python-pip libldap2-dev libpq-dev libsasl2-dev

Then run:

pip install -r requirements.txt

You should now be able to run python (within the virtualenv, obviously) without error.

The coin/ file is ignored by Git: feel free to override any setting by writing into that file. For example, to override the DEBUG settings:

echo '# -*- coding: utf-8 -*-' > coin/
echo 'DEBUG = TEMPLATE_DEBUG = True' >> coin/

At this point, you should setup your database. Recommended is postgreSQL, but you might be able to use SQLite. For more information, see

If you don't want to use LDAP, just set in your


The first time, you need to create the database, create a superuser, and import some base data to play with:

python migrate
python createsuperuser
python loaddata offers ip_pool

Note that the superuser will be inserted into the LDAP backend exactly in the same way as all other members, so you should use a real account (not just admin/admin).

Then, at each code update, you only need to apply migrations:

python migrate

At this point, Django should run correctly:

python runserver


You should first setup the sites application, in the admin. The domain name configured there is used for outgoing emails.

ISP-specific configuration

The main place to customize Coin for your ISP is the IspDatabase application, in the admin. Information entered in this application has two purposes:

1) generate a JSON file usable by

2) customize the user interface (postal address, bank account, ISP name & logo...)

Some bits of configuration are done in LDAP branches, RSS feeds to display on the home page, and so on.

More information

For the rest of the setup (database, LDAP), see

For real production deployment, see file