Captive Portal software setup guide for raspian/debian

First install the ezwifiportal dependencies

command: sudo apt-get install apache2 php5 php5-sqlite php5-gd libapache2-mod-php5

Activate a2enmod rewrite

command: sudo a2enmod rewrite

Setup captive-portal software

command: sudo mkdir -p /var/www/html/captive_portal && cd /var/www/html/captive_portal

command: sudo wget

command: sudo unzip

command: sudo chown www-data:www-data -R *

command: sudo php artisan key:generate

Edit your apache default site, and insert the code below:

command: sudo vi /etc/apache2/sites-available/000-default.conf
<VirtualHost *:80>

  <Directory /var/www/html/captive_portal/public>
    Options Indexes FollowSymLinks MultiViews
    AllowOverride All
    Order allow,deny
    allow from all
  DocumentRoot /var/www/html/captive_portal/public

  ErrorLog ${APACHE_LOG_DIR}/error.log
  CustomLog ${APACHE_LOG_DIR}/access.log combined


Restart your device, and continue in a browser

command: sudo reboot

Screenshots of the setup process in the browser

Technical details

EZ Wifi Portal technical details

The default firewall and captive portal configuration of our Gold and Platinum packages are made for ease of use, while still being secure.

The WAN interface of the firewall is set to DHCP, while the LAN interface is set to

This means you will be able to plug it into your existing network, and the firewall rules will make sure only the internet is accessible, as all requests to RFC1918 ip space is blocked (,,

If you plug the firewall into your current RFC1918 LAN segment, the firewall will do double nat. In most cases this is not a problem for a guest network. If you have more advanced requirements, vlans, public address space or anything else - get in touch.

The touchscreen in the Gold and Platinum packages comes with 65.000 unique vouchers preinstalled.

If you have 50 guests a day for 250 working days a year, you will use 12.500 vouchers a year. Which means the system can run unattended for 5 years. When you need to reload the keys, it's a process that takes about 10 minutes and costs you $0.