doc/install/gateway

Version 1 (modified by benoitg, 14 years ago)

--

Q: What do I need ?

A:

  1. Basic proficiency in a Linux environment
  2. A Linux OS with netfilter compiled into the kernel
  3. The iptables package
  4. The GNU C compiler (gcc). Other compilers may work, but we have not tested and will not support them.
  5. The latest Wifidog tarball which can be obtained from  SourceForge

Q: Pre-installation

A: This is where a lot of people run into problems, so let's state this in bold:

MAKE SURE EVERYTHING WORKS FIRST BEFORE INTRODUCING Wifidog INTO THE ENVIRONMENT

That especially means:

  • The router must boot properly
  • The router must bring up the interfaces properly
  • The router must set up the routes properly
  • The router must connect to the internet properly
  • DNS settings must be set or obtained properly. DNS must work.
  • DHCP settings (client, server or both) must be set or obtained properly.
  • If using NAT, the router must setup NAT/masquerading rules with iptables properly
  • Clients on the desired (WIFI) network must be able to bind, associate, lease and connect the internet properly
  • All the above must happen automatically when the router starts or gets rebooted

Do NOT proceed with installing Wifidog until you've satisfied the above. It will not work otherwise and you will waste lots of time.

Q: Installation

A: Wifidog, like many open source projects, is distributed with standard autotools utilities to make installation easy. Unpack the tarball, then follow the standard:

./configure
make
make install

Q: Configuration

A: Edit /etc/wifidog.conf and follow the instructions in the file. Things should be self-explanatory.

Q: Running Wifidog for the first time

A: Run Wifidog with the following switches:

wifidog -f -d 7
  -f means to run in foreground (do not become a background daemon)
  -d 7 increases debug output level to the maximum

Q: Testing

A: As a client on the WiFi network (or whatever interface is configured as the LAN interface in /etc/wifidog.conf), open a web browser and try to browse to your favourite web site.

Monitor the output of the running Wifidog to see what it's doing.