[[PageOutline(1-2)]]
=  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
}}}

It will crash, but:

== PostgreSQL 8.1 configuration file ==

{{{
nano /etc/postgresql/8.1/main/postgresql.conf
}}}
and change:
{{{
#listen_addresses='localhost'
}}}

for

{{{
listen_addresse='*'
}}}

NOTE: this is not a good security setting, you should make sure you change that later on! 

== Install prerequisites - step2 ==

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
wget http://ovh.dl.sourceforge.net/sourceforge/phlickr/Phlickr-0.2.5.tgz
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 https://dev.wifidog.org/svn/trunk/wifidog-auth
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/
}}}

to

{{{
        DocumentRoot /var/www/wifidog-auth/wifidog
}}}

remove the rewrite rule around line 16

restart apache2:

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


== 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');

}}}
by
{{{
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 http://your-domaine.com/install.php and follow the instructions. They will ask to :

{{{
su - postgres
createuser wifidog --pwprompt 
}}}
answer no to both question

and
 
{{{
createdb wifidog --encoding=UTF-8 --owner=wifidog
}}}