Initialization

The pineapple came with a card that included a link (https://wifipineapple.com/tetra) to their setup instructions. These instructions were super useful and accurate.

SSH Setup

It is recommended to install your ssh key on the device. This will allow for transfers between your machine and the pineapple to happen easier.

Capture Portal Setup

To setup the portal, go to the Modules tab:

Select Get Modules from Hak5 Community Repositories and install Evil Portal.

Once the extension is installed, select Evil Portal which is available under the Modules tab:

This is the main screen for editing the module. Type in a name and select Create a New Portal. This will create the files that will be served from the device.

The portal files will be stored in /root/portals/<name of portal>/. Copy the files from the repository into this directory. You will have to overwrite MyPortal.php and index.php.

Note that MyPortal.php and index.php are required files for the portal to work. The portal framework expects to see these files to function properly.

Once the files are copied, then start the Captive Portal using the GUI. In addition, be sure to activate your portal site. All of these options can bee seen in the screenshot above.

DNS Redirect Setup

While the portal will redirect users who attempt to connect to the router's ip address, it does not help with computers that automatically attempt to detect if there is a capture portal. All DNS queries should be redirected to the main website. This is possible with dnsmasq. This should be installed on the device by default.

Through ssh, edit the /etc/dnsmasq.conf file on the router to have these two lines only:

no-dhcp-interface=
address=/#/172.16.42.1

The special line is the address value. It states that all requests should redirect to the router's IP address. This means all connectivity checks will return back to our portal.