Introduction

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

Some more libs

pear install XML_RPC
cd /tmp
wget http://ovh.dl.sourceforge.net/sourceforge/phlickr/Phlickr-0.2.5.tgz
pear install --alldeps 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 https://dev.wifidog.org/svn/trunk/wifidog-auth
sudo mv wifidog-auth/ /var/www/

Apache 2 configuration file

PostgreSQL 8.1 configuration file

Configure locale in wifidog.conf

Configure the auth server

Go to  http://your_server_adress_here/wifidog-auth/wifidog/install.php and follow the instructions.