Version 7 (modified by pascal.charest@…, 15 years ago)



These are step by step instructions to install Wifidog auth-server on Debian Linux (testing, 2.6.17).

December 11th, 2006 - This document is currently a draft and not completed! There might be a lot more package that is really required in the "prerequisites" section.

Step-by-step instructions

Install the distro

A minimum install without any specific package is enough, as long as you have internet access and apt installed.

Install prerequisites

Before we install anything lets be sure we have access to internet and that our apt database is updated

apt-get update

The authentification server require apache and php (we install the latest version)

apt-get install apache2 php5

It also require a database server. PostgreSQL 8.1 and 7.4 are available, but since 8.1 is faster... the choice is easy.

apt-get install postgresql-8.1

We also need some specifics librairies

apt-get install xml-core gettext mcrypt libapache2-mod-php5 php5-cgi
apt-get install php5-mcrypt php5-mhash php5-pgsql php-pear php5-xmlrpc php5-curl

To get the latest version of wifidog-auth we will need subversion:

apt-get install subversion

If you want multi-locales support, you will have to install that packages (or configure every one of them).

apt-get install locales-all

Some more libs

pear install XML_RPC
cd /tmp
pear install Phlickr-0.2.5.tgz 
rm Phlickr-0.2.5.tgz

Some stuff that isn't needed for the install, but still nice to have on a server (and which won't be install by default). If you don't what these are, you might not need them ;-)

apt-get install openssh less

Install the auth server

svn checkout
mv wifidog-auth/ /var/www/

Apache 2 configuration file

We need to change the document root. We take for granted that this server will be of no other "web" use... if it is, guess you'll have to learn how to configure apache2.

nano /etc/apache2/sites-available/default

and change (at the fifth line):

        DocumentRoot /var/www/


        DocumentRoot /var/www/wifidog-auth/wifidog

remove the rewrite rule around line 16

restart apache2:

cd /etc/init.d/
./apache2 restart

PostgreSQL 8.1 configuration file

In PostgreSQL 7.4 we had to change the listen_tcp to true... doesn't seem to be much to change in 8.1

Configure locale in wifidog.conf

If you are using an english only server on which locale "ca_FR" isn't installed, you will have to change the file :

nano /var/www/wifidog-auth/wifidog/config.php

on line 208 (ctrl+w+enter, ctrl+t+enter, 208) remplace

define('DEFAULT_LANG', 'fr_CA');


define('DEFAULT_LANG', 'en_US');

Configure mail server

You need to have a valid mailer in order to mail account confirmation!

Installing postfix

apt-get install postfix

Select the "internet site with smart host" configuration option and answer the next series of questions.

Configure the auth server

Go to and follow the instructions.